@blockml/compiler 0.1.0

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

@@ -0,0 +1,42 @@
+<!--
+  Compiler Runtime API — RenderOutputFile
+  FQN: org.blockml.bml.compiler.runtime.api.RenderOutputFile
+-->
+<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>RenderOutputFile</name>
+  <type>runapi:RenderOutputFile</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Single path/content pair in RenderOutput</is>
+
+  <documentation>C4: targets emit zero or more files; host writes them.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <path type="type:Text"><documentation>Relative output path. (required)</documentation></path>
+    <content type="type:Text"><documentation>File content. (required)</documentation></content>
+  </properties>
+
+</block>

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

@@ -0,0 +1,49 @@
+<!--
+  Compiler Runtime API — RenderSession
+  FQN: org.blockml.bml.compiler.runtime.api.RenderSession
+-->
+<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>RenderSession</name>
+  <type>runapi:RenderSession</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Immutable per-compile session shared by RenderContext forks</is>
+
+  <documentation>C1: built by BuildRenderSession after scope bootstrap or BOM-first host registry.
+    Domain-agnostic — no MachineBlocks or product-profile fields.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+    <see type="rundocumentation:ExternalTargetContract" relation="SeeAlso" />
+  </references>
+  <properties>
+    <typeRegistry type="type:Text"><documentation>TypeRegistry for this compile. (required)</documentation></typeRegistry>
+    <sourceFilePath type="type:Text"><documentation>Document path or scope placeholder. (required)</documentation></sourceFilePath>
+    <outputBasePath type="type:Text"><documentation>Output base path. (required)</documentation></outputBasePath>
+    <targetName type="type:Text"><documentation>Registered target name. (required)</documentation></targetName>
+    <scopeKind type="type:Text"><documentation>Resolved kind without auto. (required)</documentation></scopeKind>
+    <libraryPaths type="type:Text"><documentation>When scope is library. (optional)</documentation></libraryPaths>
+    <corpusRoots type="type:Text"><documentation>When scope is corpus. (optional)</documentation></corpusRoots>
+  </properties>
+
+</block>

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

@@ -0,0 +1,44 @@
+<!--
+  Compiler Runtime API — RenderTarget
+  FQN: org.blockml.bml.compiler.runtime.api.RenderTarget
+-->
+<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>RenderTarget</name>
+  <type>runapi:RenderTarget</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Registered Stage-3 render target contract</is>
+
+  <documentation>C3/C7: name, accepts[], optional validateRequest, render(request, ctx).</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <name type="type:Text"><documentation>Registry key / CLI target name. (required)</documentation></name>
+    <accepts type="type:Text"><documentation>CompileScopeKind values this target accepts. (required)</documentation></accepts>
+    <validateRequest type="type:Text"><documentation>Optional request validation returning diagnostics. (optional)</documentation></validateRequest>
+    <render type="type:Text"><documentation>Produce RenderOutput from request and context. (required)</documentation></render>
+  </properties>
+
+</block>

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

@@ -0,0 +1,44 @@
+<!--
+  Compiler Runtime API — ResolvedScope
+  FQN: org.blockml.bml.compiler.runtime.api.ResolvedScope
+-->
+<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>ResolvedScope</name>
+  <type>runapi:ResolvedScope</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Concrete scope after ResolveScope (never auto)</is>
+
+  <documentation>kind is document | library | corpus with corresponding payload fields.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <kind type="type:Text"><documentation>Resolved kind without auto. (required)</documentation></kind>
+    <document type="runapi:CompileInput"><documentation>When kind is document. (optional)</documentation></document>
+    <libraries type="type:Text"><documentation>When kind is library. (optional)</documentation></libraries>
+    <roots type="type:Text"><documentation>When kind is corpus. (optional)</documentation></roots>
+  </properties>
+
+</block>

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

@@ -0,0 +1,43 @@
+<!--
+  Compiler Runtime API — ScopeConfigHints
+  FQN: org.blockml.bml.compiler.runtime.api.ScopeConfigHints
+-->
+<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>ScopeConfigHints</name>
+  <type>runapi:ScopeConfigHints</type>
+  <baseType>runtime:RuntimeType</baseType>
+  <is>Host hints merged into ResolveScope</is>
+
+  <documentation>CLI passes libraries/roots/rootDir from bom.config.json.</documentation>
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+  <properties>
+    <libraries type="type:Text"><documentation>Fallback Library.bml paths. (optional)</documentation></libraries>
+    <roots type="type:Text"><documentation>Fallback corpus roots. (optional)</documentation></roots>
+    <rootDir type="type:Text"><documentation>Root for empty-scope diagnostics. (optional)</documentation></rootDir>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/BuildRenderSession.bml

@@ -0,0 +1,49 @@
+<!--
+  Compiler Runtime Capability — BuildRenderSession
+  FQN: org.blockml.bml.compiler.runtime.capability.BuildRenderSession
+-->
+<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>BuildRenderSession</name>
+  <type>runcap:BuildRenderSession</type>
+  <baseType>core:Capability</baseType>
+  <is>Construct RenderSession from bootstrap or BOM-first results</is>
+
+  <documentation>C1: defaults sourceFilePath to the literal placeholder scope (angle brackets),
+    outputBasePath to dot. Session fields are domain-agnostic.</documentation>
+
+  <references>
+    <see type="rundocumentation:RenderContextRules" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <options type="type:Text">
+      <documentation>Session field bag including typeRegistry, targetName, scopeKind. (required)</documentation>
+    </options>
+    <result type="runapi:RenderSession">
+      <documentation>Immutable session. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/ClearTargets.bml

@@ -0,0 +1,41 @@
+<!--
+  Compiler Runtime Capability — ClearTargets
+  FQN: org.blockml.bml.compiler.runtime.capability.ClearTargets
+-->
+<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>ClearTargets</name>
+  <type>runcap:ClearTargets</type>
+  <baseType>core:Capability</baseType>
+  <is>Clear all registered targets</is>
+
+  <documentation>Used by tests and host re-bootstrap. C3: no default re-seed.</documentation>
+
+  <references>
+    <see type="rundocumentation:TargetRegistry" relation="SeeAlso" />
+  </references>
+
+
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/CompileBmlToBom.bml

@@ -0,0 +1,52 @@
+<!--
+  Compiler Runtime Capability — CompileBmlToBom
+  FQN: org.blockml.bml.compiler.runtime.capability.CompileBmlToBom
+-->
+<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>CompileBmlToBom</name>
+  <type>runcap:CompileBmlToBom</type>
+  <baseType>core:Capability</baseType>
+  <is>Parse then validate a single BML document to BomDocument</is>
+
+  <documentation>Orchestrates parser parse and validator validate; does not own mapping algorithms.</documentation>
+
+  <references>
+    <see type="parser:Library" relation="SeeAlso" />
+    <see type="validator:Library" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <input type="runapi:CompileInput">
+      <documentation>Source unit. (required)</documentation>
+    </input>
+    <options type="runapi:CompileOptions">
+      <documentation>May supply typeRegistry. (optional)</documentation>
+    </options>
+    <result type="runapi:CompilerResult">
+      <documentation>BomDocument envelope. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/CompileBmlToOutput.bml

@@ -0,0 +1,54 @@
+<!--
+  Compiler Runtime Capability — CompileBmlToOutput
+  FQN: org.blockml.bml.compiler.runtime.capability.CompileBmlToOutput
+-->
+<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>CompileBmlToOutput</name>
+  <type>runcap:CompileBmlToOutput</type>
+  <baseType>core:Capability</baseType>
+  <is>Document-scope sugar for CompileToOutput</is>
+
+  <documentation>Wraps CompileInput as scope kind document then calls CompileToOutput.</documentation>
+
+  <references>
+    <see type="runcap:CompileToOutput" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <input type="runapi:CompileInput">
+      <documentation>BML source unit. (required)</documentation>
+    </input>
+    <targetName type="type:Text">
+      <documentation>Registered target name. (required)</documentation>
+    </targetName>
+    <options type="runapi:CompileOptions">
+      <documentation>Host options. (optional)</documentation>
+    </options>
+    <result type="runapi:CompilerResult">
+      <documentation>RenderOutput envelope. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/CompileBomToOutput.bml

@@ -0,0 +1,60 @@
+<!--
+  Compiler Runtime Capability — CompileBomToOutput
+  FQN: org.blockml.bml.compiler.runtime.capability.CompileBomToOutput
+-->
+<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>CompileBomToOutput</name>
+  <type>runcap:CompileBomToOutput</type>
+  <baseType>core:Capability</baseType>
+  <is>BOM-first Stage-3 sugar with required TypeRegistry</is>
+
+  <documentation>Renders an existing BomDocument without re-parse or bootstrap.
+    Requires CompileBomOptions.typeRegistry (BML_MISSING_TYPE_REGISTRY when absent).
+    Document scope only — target.accepts must include document.
+    Registry is passed through unchanged; host owns registry contents.
+    Synthetic CompileRequest uses scope kind document and optional targetOptions.</documentation>
+
+  <references>
+    <see type="runcap:CompileToOutput" relation="SeeAlso" />
+    <see type="runapi:CompileBomOptions" relation="SeeAlso" />
+    <see type="rundocumentation:ExternalTargetContract" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <document type="type:Text">
+      <documentation>BomDocument to render. (required)</documentation>
+    </document>
+    <targetName type="type:Text">
+      <documentation>Registered target name. (required)</documentation>
+    </targetName>
+    <options type="runapi:CompileBomOptions">
+      <documentation>BOM-first options including required typeRegistry. (required)</documentation>
+    </options>
+    <result type="runapi:CompilerResult">
+      <documentation>RenderOutput envelope. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/CompileToOutput.bml

@@ -0,0 +1,58 @@
+<!--
+  Compiler Runtime Capability — CompileToOutput
+  FQN: org.blockml.bml.compiler.runtime.capability.CompileToOutput
+-->
+<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>CompileToOutput</name>
+  <type>runcap:CompileToOutput</type>
+  <baseType>core:Capability</baseType>
+  <is>Normative Stage-3 facade: request plus target name to CompilerResult</is>
+
+  <documentation>C2: getTarget → optional validateRequest → ResolveScope → scopeAccepts → bootstrapForScope → (document: ValidateRegistryDocuments) → BuildRenderSession → CreateRenderContext → target.render. Emits BML_UNKNOWN_TARGET / BML_TARGET_SCOPE_MISMATCH.</documentation>
+
+  <references>
+    <see type="rundocumentation:PublicApi" relation="SeeAlso" />
+    <see type="rundocumentation:ArchitectureOverview" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <request type="runapi:CompileRequest">
+      <documentation>Compile request. (required)</documentation>
+    </request>
+    <targetName type="type:Text">
+      <documentation>Registered target name. (required)</documentation>
+    </targetName>
+    <options type="runapi:CompileOptions">
+      <documentation>Host compile options. (optional)</documentation>
+    </options>
+    <configHints type="runapi:ScopeConfigHints">
+      <documentation>Scope hints from host config. (optional)</documentation>
+    </configHints>
+    <result type="runapi:CompilerResult">
+      <documentation>RenderOutput envelope. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/CreateRenderContext.bml

@@ -0,0 +1,54 @@
+<!--
+  Compiler Runtime Capability — CreateRenderContext
+  FQN: org.blockml.bml.compiler.runtime.capability.CreateRenderContext
+-->
+<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>CreateRenderContext</name>
+  <type>runcap:CreateRenderContext</type>
+  <baseType>core:Capability</baseType>
+  <is>Create root RenderContext for a session</is>
+
+  <documentation>C1: optional blockFqn and outputRelativePath default empty; child forks overrides.</documentation>
+
+  <references>
+    <see type="rundocumentation:RenderContextRules" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <session type="runapi:RenderSession">
+      <documentation>Session. (required)</documentation>
+    </session>
+    <blockFqn type="type:Text">
+      <documentation>Initial block FQN. (optional)</documentation>
+    </blockFqn>
+    <outputRelativePath type="type:Text">
+      <documentation>Initial relative path. (optional)</documentation>
+    </outputRelativePath>
+    <result type="runapi:RenderContext">
+      <documentation>Root context. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/runtime/capability/GetTarget.bml

@@ -0,0 +1,48 @@
+<!--
+  Compiler Runtime Capability — GetTarget
+  FQN: org.blockml.bml.compiler.runtime.capability.GetTarget
+-->
+<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>GetTarget</name>
+  <type>runcap:GetTarget</type>
+  <baseType>core:Capability</baseType>
+  <is>Look up a registered RenderTarget by name</is>
+
+  <documentation>Returns undefined when missing; CompileToOutput turns that into BML_UNKNOWN_TARGET.</documentation>
+
+  <references>
+    <see type="rundocumentation:TargetRegistry" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <name type="type:Text">
+      <documentation>Target name. (required)</documentation>
+    </name>
+    <result type="runapi:RenderTarget">
+      <documentation>Target or absent. (optional)</documentation>
+    </result>
+  </properties>
+
+</block>