@blockml/compiler 0.9.3 → 0.9.5

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

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Capability — ValidateRegistryDocuments
-  FQN: org.blockml.bml.compiler.runtime.capability.ValidateRegistryDocuments
--->
-<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
-                      "
+<!--Compiler Runtime Capability — ValidateRegistryDocuments
+  FQN: org.blockml.bml.compiler.runtime.capability.ValidateRegistryDocuments-->
+<runcap:ValidateRegistryDocuments xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,29 +19,35 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:validator="org.blockml.bml.compiler.validator">
 
-  <name>ValidateRegistryDocuments</name>
-  <type>runcap:ValidateRegistryDocuments</type>
-  <baseType>core:Capability</baseType>
-  <is>Re-validate BomDocuments in a TypeRegistry</is>
-
-  <documentation>Dedupes by filePath; optional filePaths filter (undefined = all; empty = none); continueOnError true.
-    Returns ValidateRegistryResult: diagnostics, blocksTested (unique filePaths), blocksWithErrors (documents with !success).</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Re-validate BomDocuments in a TypeRegistry
+  </is>
+  <documentation>
+    Dedupes by filePath; optional filePaths filter (undefined = all; empty = none); continueOnError true.
+    Returns ValidateRegistryResult: diagnostics, blocksTested (unique filePaths), blocksWithErrors (documents with !success).
+  </documentation>
   <references>
     <see type="validator:Library" relation="SeeAlso" />
     <see type="runapi:ValidateRegistryResult" relation="SeeAlso" />
   </references>
-
   <properties>
     <typeRegistry type="type:Text">
-      <documentation>TypeRegistry. (required)</documentation>
+      <documentation>
+        TypeRegistry. (required)
+      </documentation>
     </typeRegistry>
     <filePaths type="type:Text">
-      <documentation>Optional path filter. undefined = all documents; empty = none. (optional)</documentation>
+      <documentation>
+        Optional path filter. undefined = all documents; empty = none. (optional)
+      </documentation>
     </filePaths>
     <result type="runapi:ValidateRegistryResult">
-      <documentation>diagnostics, blocksTested, blocksWithErrors. (required)</documentation>
+      <documentation>
+        diagnostics, blocksTested, blocksWithErrors. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</runcap:ValidateRegistryDocuments>

package/blocks/org/blockml/bml/compiler/runtime/config/RuntimeConstants.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Config — RuntimeConstants
-  FQN: org.blockml.bml.compiler.runtime.config.RuntimeConstants
--->
-<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
-                      "
+<!--Compiler Runtime Config — RuntimeConstants
+  FQN: org.blockml.bml.compiler.runtime.config.RuntimeConstants-->
+<runconfig:RuntimeConstants xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,19 +19,41 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:validator="org.blockml.bml.compiler.validator">
 
-  <name>RuntimeConstants</name>
-  <type>runconfig:RuntimeConstants</type>
-  <baseType>runtime:RuntimeType</baseType>
-  <is>Well-known diagnostic codes and scope kind literals</is>
-
-  <documentation>Codes emitted by ResolveScope and CompileToOutput / CompileBomToOutput.
-    Scope kinds mirror CompileScopeKind.</documentation>
+  <baseType>
+    runtime:RuntimeType
+  </baseType>
+  <is>
+    Well-known diagnostic codes and scope kind literals
+  </is>
+  <documentation>
+    Codes emitted by ResolveScope and CompileToOutput / CompileBomToOutput.
+    Scope kinds mirror CompileScopeKind.
+  </documentation>
   <properties>
-    <BML_UNKNOWN_TARGET type="type:Text"><documentation>Unknown render target name.</documentation></BML_UNKNOWN_TARGET>
-    <BML_TARGET_SCOPE_MISMATCH type="type:Text"><documentation>Resolved scope kind not in target.accepts.</documentation></BML_TARGET_SCOPE_MISMATCH>
-    <BML_COMPILE_SCOPE_EMPTY type="type:Text"><documentation>Missing document/libraries/roots or auto found nothing.</documentation></BML_COMPILE_SCOPE_EMPTY>
-    <BML_MISSING_TYPE_REGISTRY type="type:Text"><documentation>compileBomToOutput requires typeRegistry.</documentation></BML_MISSING_TYPE_REGISTRY>
-    <SCOPE_KINDS type="type:Text"><documentation>document, library, corpus, auto</documentation></SCOPE_KINDS>
+    <BML_UNKNOWN_TARGET type="type:Text">
+      <documentation>
+        Unknown render target name.
+      </documentation>
+    </BML_UNKNOWN_TARGET>
+    <BML_TARGET_SCOPE_MISMATCH type="type:Text">
+      <documentation>
+        Resolved scope kind not in target.accepts.
+      </documentation>
+    </BML_TARGET_SCOPE_MISMATCH>
+    <BML_COMPILE_SCOPE_EMPTY type="type:Text">
+      <documentation>
+        Missing document/libraries/roots or auto found nothing.
+      </documentation>
+    </BML_COMPILE_SCOPE_EMPTY>
+    <BML_MISSING_TYPE_REGISTRY type="type:Text">
+      <documentation>
+        compileBomToOutput requires typeRegistry.
+      </documentation>
+    </BML_MISSING_TYPE_REGISTRY>
+    <SCOPE_KINDS type="type:Text">
+      <documentation>
+        document, library, corpus, auto
+      </documentation>
+    </SCOPE_KINDS>
   </properties>
-
-</block>
+</runconfig:RuntimeConstants>

package/blocks/org/blockml/bml/compiler/runtime/documentation/ArchitectureOverview.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — ArchitectureOverview
-  FQN: org.blockml.bml.compiler.runtime.documentation.ArchitectureOverview
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — ArchitectureOverview
+  FQN: org.blockml.bml.compiler.runtime.documentation.ArchitectureOverview-->
+<rundocumentation:ArchitectureOverview xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,24 +20,26 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ArchitectureOverview</name>
-  <type>rundocumentation:ArchitectureOverview</type>
-  <baseType>core:Documentation</baseType>
-  <is>Modules and compileToOutput data flow</is>
-
-  <documentation>Public modules map to capabilities:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Modules and compileToOutput data flow
+  </is>
+  <documentation>
+    Public modules map to capabilities:
     types.ts → api/*; target-registry.ts → Register/Get/Clear/RegisteredTargetNames;
     scope.ts → ResolveScope, ScopeAccepts;
     compile-bml-to-bom.ts → CompileBmlToBom, ValidateRegistryDocuments;
     compile-to-output.ts → CompileToOutput (+ sugar);
     render-context.ts → BuildRenderSession, CreateRenderContext.
-
+    
     CompileToOutput pipeline: getTarget → validateRequest? → ResolveScope → ScopeAccepts →
     bootstrapForScope (document parse/register or framework bootstrapTypeRegistry) →
-    document ValidateRegistryDocuments → BuildRenderSession → CreateRenderContext → render.</documentation>
+    document ValidateRegistryDocuments → BuildRenderSession → CreateRenderContext → render.
+  </documentation>
   <references>
     <see type="rundocumentation:V1Scope" relation="ReadNext" />
     <see type="runcap:CompileToOutput" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:ArchitectureOverview>

package/blocks/org/blockml/bml/compiler/runtime/documentation/CompileIO.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — CompileIO
-  FQN: org.blockml.bml.compiler.runtime.documentation.CompileIO
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — CompileIO
+  FQN: org.blockml.bml.compiler.runtime.documentation.CompileIO-->
+<rundocumentation:CompileIO xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,26 +20,26 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>CompileIO</name>
-  <type>rundocumentation:CompileIO</type>
-  <baseType>core:Documentation</baseType>
-  <is>Compile I/O model (C4)</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Compile I/O model (C4)
+  </is>
   <documentation>
     # Compile I/O model (C4)
-
+    
     C4: BlockML has no mandatory input↔output cardinality. Targets decide how many files
     (including zero) and may attach side fields on RenderOutput subtypes.
-
+    
     Hosts write files; the compiler returns opaque RenderOutput.
-
+    
     MachineBlocks 1 BML → 1 SCAD is a domain convention, not a compiler rule.
-
+    
     TypeRegistry population follows resolved scope (document vs library vs corpus), not a fixed I/O map.
   </documentation>
   <references>
     <see type="rundocumentation:CompileScopeRules" relation="ReadNext" />
     <see type="runapi:RenderOutput" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:CompileIO>

package/blocks/org/blockml/bml/compiler/runtime/documentation/CompileScopeRules.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — CompileScopeRules
-  FQN: org.blockml.bml.compiler.runtime.documentation.CompileScopeRules
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — CompileScopeRules
+  FQN: org.blockml.bml.compiler.runtime.documentation.CompileScopeRules-->
+<rundocumentation:CompileScopeRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,23 +20,24 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>CompileScopeRules</name>
-  <type>rundocumentation:CompileScopeRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>Compile scope resolution and accepts (C7)</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Compile scope resolution and accepts (C7)
+  </is>
   <documentation>
     # Compile scope resolution and accepts (C7)
-
+    
     Kinds: document | library | corpus | auto.
-
+    
     ResolveScope: document requires scope.document; library uses libraries then hints.libraries;
     corpus uses roots then hints.roots; auto prefers libraries then roots; else BML_COMPILE_SCOPE_EMPTY.
-
+    
     ScopeAccepts: exact kind match, or accepts includes auto and kind is library or corpus.
-
+    
     CompileToOutput rejects with BML_TARGET_SCOPE_MISMATCH when ScopeAccepts is false.
-
+    
     Accepts matrix for concrete targets lives in target libraries / CLI TargetCliMatrix — not here.
   </documentation>
   <references>
@@ -50,5 +45,4 @@
     <see type="runcap:ResolveScope" relation="SeeAlso" />
     <see type="runcap:ScopeAccepts" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:CompileScopeRules>

package/blocks/org/blockml/bml/compiler/runtime/documentation/DesignDecisions.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — DesignDecisions
-  FQN: org.blockml.bml.compiler.runtime.documentation.DesignDecisions
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — DesignDecisions
+  FQN: org.blockml.bml.compiler.runtime.documentation.DesignDecisions-->
+<rundocumentation:DesignDecisions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,32 +20,32 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>DesignDecisions</name>
-  <type>rundocumentation:DesignDecisions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Normative Phase C decisions C1–C7</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Normative Phase C decisions C1–C7
+  </is>
   <documentation>
     # Normative Phase C decisions C1–C7
-
+    
     C1 RenderContext = RenderSession plus forked per-node context; internal render API.
-
+    
     C2 Facade = compileToOutput(CompileRequest, …); compileBmlToOutput is document sugar;
     compileBomToOutput is BOM-first with required TypeRegistry (no re-parse/bootstrap).
-
+    
     C3 Registry has no defaults; hosts register; targets[] bootstrap is CLI config (cross-ref);
     registerTarget validates name, accepts, render.
-
+    
     C4 No mandatory input↔output mapping; RenderOutput opaque (files[] base).
-
+    
     C5 Incremental build is CLI-only (boundary); not a runtime capability.
-
+    
     C6 Thumbnails are CLI-only; not part of RenderOutput.
-
+    
     C7 Scope document | library | corpus | auto; accepts[]; opaque targetOptions.
   </documentation>
   <references>
     <see type="rundocumentation:PackageOwnership" relation="ReadNext" />
   </references>
-
-</block>
+</rundocumentation:DesignDecisions>

package/blocks/org/blockml/bml/compiler/runtime/documentation/Diagnostics.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — Diagnostics
-  FQN: org.blockml.bml.compiler.runtime.documentation.Diagnostics
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — Diagnostics
+  FQN: org.blockml.bml.compiler.runtime.documentation.Diagnostics-->
+<rundocumentation:Diagnostics xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,32 +20,32 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Diagnostics</name>
-  <type>rundocumentation:Diagnostics</type>
-  <baseType>core:Documentation</baseType>
-  <is>Compiler envelope diagnostic codes</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Compiler envelope diagnostic codes
+  </is>
   <documentation>
     # Compiler envelope diagnostic codes
-
+    
     Runtime-owned codes:
     BML_UNKNOWN_TARGET — getTarget missed.
-
+    
     BML_TARGET_SCOPE_MISMATCH — resolved kind not accepted.
-
+    
     BML_COMPILE_SCOPE_EMPTY — missing document/libraries/roots or auto empty.
-
+    
     BML_MISSING_TYPE_REGISTRY — compileBomToOutput called without typeRegistry.
-
+    
     Parse/validate diagnostics are forwarded from parser/validator.
-
+    
     success on CompilerResult is false if any diagnostic has severity error.
-
+    
     CLI maps diagnostics to exit codes — not modeled here.
   </documentation>
   <references>
     <see type="rundocumentation:DesignDecisions" relation="ReadNext" />
     <see type="runconfig:RuntimeConstants" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:Diagnostics>

package/blocks/org/blockml/bml/compiler/runtime/documentation/ExternalTargetContract.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — ExternalTargetContract
-  FQN: org.blockml.bml.compiler.runtime.documentation.ExternalTargetContract
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — ExternalTargetContract
+  FQN: org.blockml.bml.compiler.runtime.documentation.ExternalTargetContract-->
+<rundocumentation:ExternalTargetContract xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,38 +20,40 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ExternalTargetContract</name>
-  <type>rundocumentation:ExternalTargetContract</type>
-  <baseType>core:Documentation</baseType>
-  <is>Normative contract for external Stage-3 RenderTargets</is>
-
-  <documentation>RenderTarget: name, accepts[], optional validateRequest, render(request, ctx) → RenderOutput
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Normative contract for external Stage-3 RenderTargets
+  </is>
+  <documentation>
+    RenderTarget: name, accepts[], optional validateRequest, render(request, ctx) → RenderOutput
     (files[] required; optional rootFiles[] at project root, optional diagnostics[] for CLI merge).
     BOM-first hosts call compileBomToOutput(document, targetName, CompileBomOptions) with a required
     TypeRegistry; no re-parse or bootstrap. Host must ensure the document is discoverable in the
     registry when the target looks up by sourceFilePath or FQN.
-
+    
     Stable RenderSession fields for registry targets: typeRegistry, sourceFilePath, outputBasePath,
     targetName, scopeKind, libraryPaths?, corpusRoots?.
     Per-node RenderContext fields (blockFqn, outputRelativePath, child) are for composition renderers;
     registry targets may ignore them.
-
+    
     Domain-specific options (MachineBlocks lib path, active config profiles, …) live in opaque
     targetOptions on CompileRequest / CompileBomOptions — not on CompileOptions or RenderSession.
     Hosts register targets via registerTarget before compile.
-
+    
     Stage-2 guarantee: hosts should run validate() or validateRegistryDocuments on the corpus
     before emit when targets depend on semantic guarantees (embedded blocks, constraints,
     instance refs).     BlockDoc/XSD compile paths may omit full corpus Stage-2 by policy;
     blockml validate remains SSOT for semantic validation.
-
+    
     @blockml/lsp (V1) — editor-agnostic stdio language server (blockml-lsp);
-    IDE clients connect via LSP. See org.blockml.bml.lsp.documentation.Introduction.</documentation>
+    IDE clients connect via LSP. See org.blockml.bml.lsp.documentation.Introduction.
+  </documentation>
   <references>
     <see type="rundocumentation:Diagnostics" relation="ReadNext" />
     <see type="runapi:RenderTarget" relation="SeeAlso" />
     <see type="runcap:CompileBomToOutput" relation="SeeAlso" />
     <see type="rundocumentation:TargetRegistry" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:ExternalTargetContract>

package/blocks/org/blockml/bml/compiler/runtime/documentation/Introduction.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — Introduction
-  FQN: org.blockml.bml.compiler.runtime.documentation.Introduction
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — Introduction
+  FQN: org.blockml.bml.compiler.runtime.documentation.Introduction-->
+<rundocumentation:Introduction xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,24 +20,26 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Introduction</name>
-  <type>rundocumentation:Introduction</type>
-  <baseType>core:Documentation</baseType>
-  <is>Purpose and scope of the compiler runtime</is>
-
-  <documentation>The @blockml/compiler package implements the Stage-3 facade and Target Registry.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Purpose and scope of the compiler runtime
+  </is>
+  <documentation>
+    The @blockml/compiler package implements the Stage-3 facade and Target Registry.
     Normative entry is compileToOutput (C2). Targets register via registerTarget; the
     registry ships with no defaults (C3). Compile scope kinds and auto resolution are C7.
-
+    
     This library (org.blockml.bml.compiler.runtime.*) is the SSOT. TypeScript in
     packages/compiler/src/ implements it. Tests in packages/compiler/test/ encode contracts.
-
+    
     Host wiring (targets[] bootstrap, file write, exit codes, C5/C6) lives in
     org.blockml.bml.cli.*. Target emit rules live in each target library.
-    Parser/validator algorithms live in their own libraries; this package orchestrates them.</documentation>
+    Parser/validator algorithms live in their own libraries; this package orchestrates them.
+  </documentation>
   <references>
     <see type="rundocumentation:LayerSeparation" relation="ReadNext" />
     <see type="runcap:CompileToOutput" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:Introduction>

package/blocks/org/blockml/bml/compiler/runtime/documentation/LayerSeparation.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — LayerSeparation
-  FQN: org.blockml.bml.compiler.runtime.documentation.LayerSeparation
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — LayerSeparation
+  FQN: org.blockml.bml.compiler.runtime.documentation.LayerSeparation-->
+<rundocumentation:LayerSeparation xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,23 +20,25 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>LayerSeparation</name>
-  <type>rundocumentation:LayerSeparation</type>
-  <baseType>core:Documentation</baseType>
-  <is>What this library owns versus neighbors</is>
-
-  <documentation>Layers:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What this library owns versus neighbors
+  </is>
+  <documentation>
+    Layers:
     • org.blockml.bml.compiler.runtime.* (this library) — facade, registry, scope, RenderContext
     • org.blockml.bml.compiler.parser.* / validator.* — Stage 1–2 algorithms
     • org.blockml.bml.framework.* — TypeRegistry bootstrap used by compileToOutput
     • org.blockml.bml.cli.* — config bootstrap, write files, C5/C6, exit codes
     • target libraries — RenderTarget.render and typed targetOptions
-
-    Do not double-maintain CLI command matrices or target particle rules here.</documentation>
+    
+    Do not double-maintain CLI command matrices or target particle rules here.
+  </documentation>
   <references>
     <see type="rundocumentation:ArchitectureOverview" relation="ReadNext" />
     <see type="cli:Library" relation="SeeAlso" />
     <see type="framework:Library" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:LayerSeparation>