@blockml/compiler 0.1.0

package/blocks/org/blockml/bml/compiler/runtime/Library.bml

@@ -0,0 +1,121 @@
+<!--
+  BlockML Compiler Runtime Library
+  FQN: org.blockml.bml.compiler.runtime.Library
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>Library</name>
+  <type>runtime:Library</type>
+  <baseType>core:BlockLibrary</baseType>
+  <is>The BlockML compiler runtime package library catalog</is>
+
+  <documentation>
+    Canonical compiler runtime specification for BlockML — compileToOutput, Target
+    Registry, compile scope, RenderContext (C1–C7). TypeScript in packages/compiler/src/
+    implements this library. Membership is defined exclusively by this blocks list.
+  </documentation>
+
+  <version>0.1.0</version>
+
+  <language>
+    <English />
+  </language>
+
+  <properties>
+    <description>
+      <value>BlockML Compiler runtime library</value>
+    </description>
+  </properties>
+
+  <aggregations>
+    <readMe>
+      <composition>
+        <runtime:README />
+      </composition>
+    </readMe>
+    <dependencies>
+      <composition>
+        <blockml:Library />
+      </composition>
+      <composition>
+        <bom:Library />
+      </composition>
+      <composition>
+        <framework:Library />
+      </composition>
+      <composition>
+        <parser:Library />
+      </composition>
+      <composition>
+        <validator:Library />
+      </composition>
+    </dependencies>
+    <blocks>
+      <composition><runtime:RuntimeType /></composition>
+      <composition><runapi:CompileScopeKind /></composition>
+      <composition><runapi:CompileInput /></composition>
+      <composition><runapi:CompileScope /></composition>
+      <composition><runapi:CompileRequest /></composition>
+      <composition><runapi:CompileOptions /></composition>
+      <composition><runapi:CompileBomOptions /></composition>
+      <composition><runapi:CompilerResult /></composition>
+      <composition><runapi:RenderOutputFile /></composition>
+      <composition><runapi:RenderOutput /></composition>
+      <composition><runapi:RenderSession /></composition>
+      <composition><runapi:RenderContext /></composition>
+      <composition><runapi:RenderTarget /></composition>
+      <composition><runapi:ScopeConfigHints /></composition>
+      <composition><runapi:ResolvedScope /></composition>
+      <composition><runconfig:RuntimeConstants /></composition>
+      <composition><runcap:CompileToOutput /></composition>
+      <composition><runcap:CompileBmlToOutput /></composition>
+      <composition><runcap:CompileBomToOutput /></composition>
+      <composition><runcap:RegisterTarget /></composition>
+      <composition><runcap:GetTarget /></composition>
+      <composition><runcap:ClearTargets /></composition>
+      <composition><runcap:RegisteredTargetNames /></composition>
+      <composition><runcap:ResolveScope /></composition>
+      <composition><runcap:ScopeAccepts /></composition>
+      <composition><runcap:CompileBmlToBom /></composition>
+      <composition><runcap:ValidateRegistryDocuments /></composition>
+      <composition><runcap:BuildRenderSession /></composition>
+      <composition><runcap:CreateRenderContext /></composition>
+      <composition><rundocumentation:Introduction /></composition>
+      <composition><rundocumentation:LayerSeparation /></composition>
+      <composition><rundocumentation:ArchitectureOverview /></composition>
+      <composition><rundocumentation:V1Scope /></composition>
+      <composition><rundocumentation:PublicApi /></composition>
+      <composition><rundocumentation:CompileIO /></composition>
+      <composition><rundocumentation:CompileScopeRules /></composition>
+      <composition><rundocumentation:TargetRegistry /></composition>
+      <composition><rundocumentation:RenderContextRules /></composition>
+      <composition><rundocumentation:ExternalTargetContract /></composition>
+      <composition><rundocumentation:Diagnostics /></composition>
+      <composition><rundocumentation:DesignDecisions /></composition>
+      <composition><rundocumentation:PackageOwnership /></composition>
+      <composition><rundocumentation:ScopeExclusions /></composition>
+    </blocks>
+  </aggregations>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/README.bml

@@ -0,0 +1,60 @@
+<!--
+  BlockML Compiler Runtime — README
+  FQN: org.blockml.bml.compiler.runtime.README
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>README</name>
+  <type>runtime:README</type>
+  <baseType>core:ReadMe</baseType>
+  <is>Reading entry for the compiler runtime library</is>
+
+  <documentation>
+    The @blockml/compiler package implements the Stage-3 facade and Target Registry.
+    This library (org.blockml.bml.compiler.runtime.*) is the SSOT; TypeScript in
+    packages/compiler/src/ implements it. Tests in packages/compiler/test/ verify contracts.
+
+    Start reading at org.blockml.bml.compiler.runtime.documentation.Introduction (ReadNext chain).
+
+    V1: compileToOutput with document|library|corpus|auto scope, empty Target Registry
+    (hosts register targets), RenderContext/Session, opaque RenderOutput. CLI owns
+    bootstrap, write, C5/C6.
+
+    Layer separation:
+    • parser / validator / framework — Stage 1–2 and TypeRegistry
+    • org.blockml.bml.compiler.runtime.* (this library) — facade and registry
+    • org.blockml.bml.cli.* — host orchestration
+    • target libraries — render emit
+
+    Modules: documentation, api/config, capability.
+  </documentation>
+
+  <references>
+    <see type="rundocumentation:Introduction" relation="ReadFirst" />
+    <see type="rundocumentation:DesignDecisions" relation="SeeAlso" />
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+    <see type="runcap:CompileToOutput" relation="SeeAlso" />
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/RuntimeType.bml

@@ -0,0 +1,36 @@
+<!--
+  Compiler Runtime — RuntimeType
+  FQN: org.blockml.bml.compiler.runtime.RuntimeType
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>RuntimeType</name>
+  <type>runtime:RuntimeType</type>
+  <baseType>core:Entity</baseType>
+  <is>Abstract marker for compiler runtime API and config data-structure blocks</is>
+
+  <documentation>All org.blockml.bml.compiler.runtime.api|config.* types extend this marker. Distinct from core:Capability and bom Urmodell types.</documentation>
+  <abstract>true</abstract>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompileBomOptions.bml

@@ -0,0 +1,46 @@
+<!--
+  Compiler Runtime API — CompileBomOptions
+  FQN: org.blockml.bml.compiler.runtime.api.CompileBomOptions
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompileBomOptions</name>
+  <type>runapi:CompileBomOptions</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Host options for compileBomToOutput (BOM-first Stage-3)</is>
+
+  <documentation>typeRegistry is required and passed through unchanged — no bootstrap or re-parse.
+    Domain-specific host fields (e.g. MachineBlocks lib path) belong in targetOptions, not here.</documentation>
+  <references>
+    <see type="runcap:CompileBomToOutput" relation="SeeAlso" />
+    <see type="rundocumentation:ExternalTargetContract" relation="SeeAlso" />
+  </references>
+  <properties>
+    <typeRegistry type="type:Text"><documentation>Pre-built TypeRegistry; required. (required)</documentation></typeRegistry>
+    <outputBasePath type="type:Text"><documentation>Output base path for session. (optional)</documentation></outputBasePath>
+    <rootDir type="type:Text"><documentation>Project root for diagnostics source paths. (optional)</documentation></rootDir>
+    <targetOptions type="type:Text"><documentation>Opaque options forwarded on the synthetic CompileRequest. (optional)</documentation></targetOptions>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompileInput.bml

@@ -0,0 +1,43 @@
+<!--
+  Compiler Runtime API — CompileInput
+  FQN: org.blockml.bml.compiler.runtime.api.CompileInput
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompileInput</name>
+  <type>runapi:CompileInput</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Single BML source unit for document scope</is>
+
+  <documentation>Used as CompileScope.document and by CompileBmlToBom / CompileBmlToOutput.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <source type="type:Text"><documentation>BML source text. (required)</documentation></source>
+    <filePath type="type:Text"><documentation>Logical file path for diagnostics. (required)</documentation></filePath>
+    <format type="type:Text"><documentation>Optional format hint; V1 only xml. (optional)</documentation></format>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompileOptions.bml

@@ -0,0 +1,44 @@
+<!--
+  Compiler Runtime API — CompileOptions
+  FQN: org.blockml.bml.compiler.runtime.api.CompileOptions
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompileOptions</name>
+  <type>runapi:CompileOptions</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Host options for compile helpers and compileToOutput</is>
+
+  <documentation>typeRegistry, paths, and session fields supplied by the host (often CLI).
+    Domain-specific passthrough fields belong in targetOptions, not here.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <typeRegistry type="type:Text"><documentation>Optional pre-built TypeRegistry. (optional)</documentation></typeRegistry>
+    <outputBasePath type="type:Text"><documentation>Output base path for session. (optional)</documentation></outputBasePath>
+    <rootDir type="type:Text"><documentation>Project root for bootstrap defaults. (optional)</documentation></rootDir>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompileRequest.bml

@@ -0,0 +1,42 @@
+<!--
+  Compiler Runtime API — CompileRequest
+  FQN: org.blockml.bml.compiler.runtime.api.CompileRequest
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompileRequest</name>
+  <type>runapi:CompileRequest</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Primary Stage-3 request envelope</is>
+
+  <documentation>C2: scope plus opaque targetOptions typed per target package.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <scope type="runapi:CompileScope"><documentation>Compile scope. (required)</documentation></scope>
+    <targetOptions type="type:Text"><documentation>Opaque options for the named target. (optional)</documentation></targetOptions>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompileScope.bml

@@ -0,0 +1,45 @@
+<!--
+  Compiler Runtime API — CompileScope
+  FQN: org.blockml.bml.compiler.runtime.api.CompileScope
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompileScope</name>
+  <type>runapi:CompileScope</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Compile scope payload on CompileRequest</is>
+
+  <documentation>C7 scope kinds with optional document, libraries, roots, includeDependencies.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <kind type="type:Text"><documentation>CompileScopeKind value. (required)</documentation></kind>
+    <document type="runapi:CompileInput"><documentation>Required when kind is document. (optional)</documentation></document>
+    <libraries type="type:Text"><documentation>Library.bml paths. (optional)</documentation></libraries>
+    <roots type="type:Text"><documentation>Corpus root directories. (optional)</documentation></roots>
+    <includeDependencies type="type:Boolean"><documentation>Reserved; host may pass through. (optional)</documentation></includeDependencies>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompileScopeKind.bml

@@ -0,0 +1,44 @@
+<!--
+  Compiler Runtime API — CompileScopeKind
+  FQN: org.blockml.bml.compiler.runtime.api.CompileScopeKind
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompileScopeKind</name>
+  <type>runapi:CompileScopeKind</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Enumerated compile scope kinds</is>
+
+  <documentation>C7: document | library | corpus | auto. auto is input-only; ResolveScope yields a concrete kind.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <document type="type:Text"><documentation>Single .bml document scope.</documentation></document>
+    <library type="type:Text"><documentation>Library.bml roots plus dependency closure.</documentation></library>
+    <corpus type="type:Text"><documentation>Directory roots / blocks trees.</documentation></corpus>
+    <auto type="type:Text"><documentation>Resolve from libraries then roots; never left as auto after ResolveScope.</documentation></auto>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/CompilerResult.bml

@@ -0,0 +1,43 @@
+<!--
+  Compiler Runtime API — CompilerResult
+  FQN: org.blockml.bml.compiler.runtime.api.CompilerResult
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>CompilerResult</name>
+  <type>runapi:CompilerResult</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Success flag, diagnostics, and optional output</is>
+
+  <documentation>Generic envelope CompilerResult of T. success is false if any error diagnostic.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <output type="type:Text"><documentation>Typed output or null. (optional)</documentation></output>
+    <diagnostics type="type:Text"><documentation>Diagnostic list. (required)</documentation></diagnostics>
+    <success type="type:Boolean"><documentation>True when no error diagnostics. (required)</documentation></success>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/RenderContext.bml

@@ -0,0 +1,43 @@
+<!--
+  Compiler Runtime API — RenderContext
+  FQN: org.blockml.bml.compiler.runtime.api.RenderContext
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>RenderContext</name>
+  <type>runapi:RenderContext</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Per-node render context with child fork</is>
+
+  <documentation>C1: session plus blockFqn and outputRelativePath; child() forks without mutating session.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <session type="runapi:RenderSession"><documentation>Shared session. (required)</documentation></session>
+    <blockFqn type="type:Text"><documentation>Current block FQN. (required)</documentation></blockFqn>
+    <outputRelativePath type="type:Text"><documentation>Relative output path hint. (required)</documentation></outputRelativePath>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/api/RenderOutput.bml

@@ -0,0 +1,43 @@
+<!--
+  Compiler Runtime API — RenderOutput
+  FQN: org.blockml.bml.compiler.runtime.api.RenderOutput
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:cli="org.blockml.bml.cli"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:runtime="org.blockml.bml.compiler.runtime"
+  xmlns:runapi="org.blockml.bml.compiler.runtime.api"
+  xmlns:runcap="org.blockml.bml.compiler.runtime.capability"
+  xmlns:runconfig="org.blockml.bml.compiler.runtime.config"
+  xmlns:rundocumentation="org.blockml.bml.compiler.runtime.documentation"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:validator="org.blockml.bml.compiler.validator">
+
+  <name>RenderOutput</name>
+  <type>runapi:RenderOutput</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Opaque Stage-3 render result</is>
+
+  <documentation>C4/C6: base shape is files[] with optional rootFiles[] and diagnostics[]. Thumbnails are not part of RenderOutput.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <files type="runapi:RenderOutputFile"><documentation>Primary artifacts under outputBasePath. (required)</documentation></files>
+    <rootFiles type="runapi:RenderOutputFile"><documentation>Root-level artifacts (e.g. catalog.xml). (optional)</documentation></rootFiles>
+    <diagnostics type="type:Text"><documentation>Target-emitted diagnostics for CLI merge. (optional)</documentation></diagnostics>
+  </properties>
+
+</block>