@blockml/fatblock-target 0.9.4 → 0.9.6

package/blocks/org/blockml/bml/target/fatblock/documentation/ArchitectureOverview.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — ArchitectureOverview
-  FQN: org.blockml.bml.target.fatblock.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
-                      "
+<!--FatBlock Documentation — ArchitectureOverview
+  FQN: org.blockml.bml.target.fatblock.documentation.ArchitectureOverview-->
+<fbdocumentation:ArchitectureOverview xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,20 +17,22 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ArchitectureOverview</name>
-  <type>fbdocumentation:ArchitectureOverview</type>
-  <baseType>core:Documentation</baseType>
-  <is>Module map and assemble pipeline</is>
-
-  <documentation>Entry: fbcap:Render (FatBlockTarget.render)
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Module map and assemble pipeline
+  </is>
+  <documentation>
+    Entry: fbcap:Render (FatBlockTarget.render)
     → ResolveOptions
     → AssembleFatDocument (RootFqnsByFilePath, CollectCandidateFqns, FilterByIncludes,
       CloneBlockDefinition, MergeNamespaceBindings)
     → SerializeFatDocument
     → FatOutputBasename
-
+    
     ValidateRequest runs before render when the host calls it; requires srcDir.
-
+    
     TypeScript module map:
     • options.ts → ResolveOptions, FatBlockOptions
     • collect-candidates.ts → RootFqnsByFilePath, CollectCandidateFqns
@@ -45,9 +41,9 @@
     • merge-namespace-bindings.ts → MergeNamespaceBindings
     • assemble-fat-document.ts → AssembleFatDocument, SerializeFatDocument
     • fat-output-path.ts → FatOutputBasename
-    • fatblock-target.ts → Render, ValidateRequest</documentation>
+    • fatblock-target.ts → Render, ValidateRequest
+  </documentation>
   <references>
     <see type="fbdocumentation:V1Scope" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:ArchitectureOverview>

package/blocks/org/blockml/bml/target/fatblock/documentation/CandidateCollection.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — CandidateCollection
-  FQN: org.blockml.bml.target.fatblock.documentation.CandidateCollection
--->
-<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
-                      "
+<!--FatBlock Documentation — CandidateCollection
+  FQN: org.blockml.bml.target.fatblock.documentation.CandidateCollection-->
+<fbdocumentation:CandidateCollection xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,23 +17,25 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>CandidateCollection</name>
-  <type>fbdocumentation:CandidateCollection</type>
-  <baseType>core:Documentation</baseType>
-  <is>Root FQN selection and include filters (FB5–FB7)</is>
-
-  <documentation>FB5 RootFqnsByFilePath: per source file, root FQN is one not prefixed by another FQN
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Root FQN selection and include filters (FB5–FB7)
+  </is>
+  <documentation>
+    FB5 RootFqnsByFilePath: per source file, root FQN is one not prefixed by another FQN
     from the same file — Sub-Block registry keys are not embed candidates.
-
+    
     FB6 CollectCandidateFqns: roots whose file path is under resolve(rootDir, srcDir);
     exclude host FQN; sort ascending; apply include when non-empty.
-
+    
     FB7 Include: pattern ending * is prefix match; else exact FQN; OR across patterns;
     empty/omitted patterns keep all candidates.
-
-    V1 semantics = folder pool, not dependency graph walk.</documentation>
+    
+    V1 semantics = folder pool, not dependency graph walk.
+  </documentation>
   <references>
     <see type="fbdocumentation:EmbedAssemblyRules" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:CandidateCollection>

package/blocks/org/blockml/bml/target/fatblock/documentation/DesignDecisions.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — DesignDecisions
-  FQN: org.blockml.bml.target.fatblock.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
-                      "
+<!--FatBlock Documentation — DesignDecisions
+  FQN: org.blockml.bml.target.fatblock.documentation.DesignDecisions-->
+<fbdocumentation:DesignDecisions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,48 +17,48 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>DesignDecisions</name>
-  <type>fbdocumentation:DesignDecisions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Normative FatBlock decisions FB1–FB20</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Normative FatBlock decisions FB1–FB20
+  </is>
   <documentation>
     # Normative FatBlock decisions FB1–FB20
-
+    
     FB1 ResolveOptions default embeddedBlocksStrategy=error.
-
+    
     FB2 accepts document only; registry name fatblock.
-
+    
     FB3 ValidateRequest requires srcDir.
-
+    
     FB4 render empty files on assemble/serialize errors; strip info diags.
-
+    
     FB5 RootFqnsByFilePath excludes Sub-Block FQNs.
-
+    
     FB6 CollectCandidateFqns path-under-src; exclude host; sort.
-
+    
     FB7 include exact or prefix*; OR; empty=all.
-
+    
     FB8 CloneBlockDefinition via structuredClone.
-
+    
     FB9 Merge host then embeds.
-
+    
     FB10 prefix collision diagnostic; no rewrite.
-
+    
     FB11 default empty-prefix xmlns.
-
+    
     FB12–FB16 assemble host/embed empty-embeds and not-found rules.
-
+    
     FB17 preserve subBlocks; clear nested embeds on clone; serialize indent 2.
-
+    
     FB18 {hostFqn}.fat.bml basename.
-
+    
     FB19 V1 = folder pool not transitive closure.
-
+    
     FB20 embeddedBlocksStrategy reserved; assemble hardcodes empty-embeds check.
   </documentation>
   <references>
     <see type="fbdocumentation:PackageOwnership" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:DesignDecisions>

package/blocks/org/blockml/bml/target/fatblock/documentation/Diagnostics.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — Diagnostics
-  FQN: org.blockml.bml.target.fatblock.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
-                      "
+<!--FatBlock Documentation — Diagnostics
+  FQN: org.blockml.bml.target.fatblock.documentation.Diagnostics-->
+<fbdocumentation:Diagnostics xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,12 +17,14 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Diagnostics</name>
-  <type>fbdocumentation:Diagnostics</type>
-  <baseType>core:Documentation</baseType>
-  <is>FatBlock-owned and shared diagnostic codes</is>
-
-  <documentation>Owned / emitted by this package:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    FatBlock-owned and shared diagnostic codes
+  </is>
+  <documentation>
+    Owned / emitted by this package:
     • BML_FATBLOCK_SRC_REQUIRED — missing srcDir
     • BML_FATBLOCK_HOST_NOT_FOUND — host file not a registry root
     • BML_FATBLOCK_HOST_HAS_EMBEDDED_BLOCKS — host already has embeds
@@ -36,13 +32,13 @@
     • BML_FATBLOCK_EMBED_HAS_EMBEDDED_BLOCKS — candidate already has embeds
     • BML_DUPLICATE_EMBEDDED_BLOCK — same FQN twice in candidates
     • BML_NAMESPACE_PREFIX_COLLISION — conflicting prefix to URI
-
+    
     Shared upstream (not reimplemented here): BML_EMBEDDED_BLOCKS_ON_SUBBLOCK,
     BML_NESTED_EMBEDDED_BLOCKS (validator); BML_NAMESPACE_UNBOUND (serializer).
-
-    Severity: all FatBlock codes are error. CLI exit: config → 2; assemble → 1.</documentation>
+    
+    Severity: all FatBlock codes are error. CLI exit: config → 2; assemble → 1.
+  </documentation>
   <references>
     <see type="fbdocumentation:DesignDecisions" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:Diagnostics>

package/blocks/org/blockml/bml/target/fatblock/documentation/EmbedAssemblyRules.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — EmbedAssemblyRules
-  FQN: org.blockml.bml.target.fatblock.documentation.EmbedAssemblyRules
--->
-<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
-                      "
+<!--FatBlock Documentation — EmbedAssemblyRules
+  FQN: org.blockml.bml.target.fatblock.documentation.EmbedAssemblyRules-->
+<fbdocumentation:EmbedAssemblyRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,12 +17,14 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>EmbedAssemblyRules</name>
-  <type>fbdocumentation:EmbedAssemblyRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>Host and embed assembly invariants (FB12–FB17)</is>
-
-  <documentation>FB12 srcDir required or BML_FATBLOCK_SRC_REQUIRED.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Host and embed assembly invariants (FB12–FB17)
+  </is>
+  <documentation>
+    FB12 srcDir required or BML_FATBLOCK_SRC_REQUIRED.
     FB13 host missing from registry → BML_FATBLOCK_HOST_NOT_FOUND.
     FB14 host.embeddedBlocks.length greater than 0 → BML_FATBLOCK_HOST_HAS_EMBEDDED_BLOCKS.
     FB15 duplicate candidate FQN → BML_DUPLICATE_EMBEDDED_BLOCK.
@@ -36,11 +32,11 @@
     embed with non-empty embeddedBlocks → BML_FATBLOCK_EMBED_HAS_EMBEDDED_BLOCKS.
     FB17 clone each embed; force cloned.embeddedBlocks empty; preserve subBlocks[];
     attach to host clone in sorted FQN order; merge namespaces; any error aborts document null.
-
+    
     Meta-model (BOM): embeds are flat under root; Sub-Blocks forbid embeds — validator owns
-    BML_EMBEDDED_BLOCKS_ON_SUBBLOCK / BML_NESTED_EMBEDDED_BLOCKS.</documentation>
+    BML_EMBEDDED_BLOCKS_ON_SUBBLOCK / BML_NESTED_EMBEDDED_BLOCKS.
+  </documentation>
   <references>
     <see type="fbdocumentation:NamespaceMergeRules" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:EmbedAssemblyRules>

package/blocks/org/blockml/bml/target/fatblock/documentation/Introduction.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — Introduction
-  FQN: org.blockml.bml.target.fatblock.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
-                      "
+<!--FatBlock Documentation — Introduction
+  FQN: org.blockml.bml.target.fatblock.documentation.Introduction-->
+<fbdocumentation:Introduction xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,28 +17,30 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Introduction</name>
-  <type>fbdocumentation:Introduction</type>
-  <baseType>core:Documentation</baseType>
-  <is>Purpose and scope of the FatBlock render target</is>
-
-  <documentation>The @blockml/fatblock-target package implements RenderTarget registry name fatblock.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Purpose and scope of the FatBlock render target
+  </is>
+  <documentation>
+    The @blockml/fatblock-target package implements RenderTarget registry name fatblock.
     It emits one portable .bml file with peer root blocks inlined under the host root
     embeddedBlocks aggregation (Inline Library model).
-
+    
     This library (org.blockml.bml.target.fatblock.*) is the SSOT. TypeScript in
     packages/fatblock-target/src/ implements it. Tests in packages/fatblock-target/test/
     encode behavioral contracts.
-
+    
     V1 is a folder-bundle target: document scope, srcDir (--src) peer pool
     (CLI defaults host and srcDir from package.json blockml.library),
     optional include FQN filters. Not transitive dependency closure (that is v2).
-
+    
     Pipeline: ResolveOptions → AssembleFatDocument → SerializeFatDocument → {hostFqn}.fat.bml.
-    Host CLI wiring (flags, exit codes) lives in org.blockml.bml.cli.*</documentation>
+    Host CLI wiring (flags, exit codes) lives in org.blockml.bml.cli.*
+  </documentation>
   <references>
     <see type="fbdocumentation:LayerSeparation" relation="ReadNext" />
     <see type="fbcap:Render" relation="SeeAlso" />
   </references>
-
-</block>
+</fbdocumentation:Introduction>

package/blocks/org/blockml/bml/target/fatblock/documentation/LayerSeparation.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — LayerSeparation
-  FQN: org.blockml.bml.target.fatblock.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
-                      "
+<!--FatBlock Documentation — LayerSeparation
+  FQN: org.blockml.bml.target.fatblock.documentation.LayerSeparation-->
+<fbdocumentation:LayerSeparation xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,29 +17,31 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>LayerSeparation</name>
-  <type>fbdocumentation:LayerSeparation</type>
-  <baseType>core:Documentation</baseType>
-  <is>FatBlock vs BOM vs serializer vs CLI</is>
-
-  <documentation>Layers relevant to FatBlock:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    FatBlock vs BOM vs serializer vs CLI
+  </is>
+  <documentation>
+    Layers relevant to FatBlock:
+    
     org.blockml.bml.target.fatblock.* (this package) — candidate collection, include filter,
     assemble/merge, FatBlockOptions, FatBlock diagnostics, output basename.
-
+    
     org.blockml.bml.bom.* — embeddedBlocks meta-model; root-only embeds; no nested embeds
     on Sub-Blocks (validator). FatBlock consumes BomDocument / BlockDefinition.
-
+    
     org.blockml.bml.compiler.serializer.* — canonical XML emit of the assembled document.
-
+    
     @blockml/compiler — RenderTarget contract, compileToOutput, document scope.
-
+    
     org.blockml.bml.cli.* — --src / --include / --out / --per-package, default host
     from package.json blockml.library, write {hostFqn}.fat.bml at the invocation directory.
-
-    Sibling targets (blockdoc, xsd) and domain SCAD are out of scope.</documentation>
+    
+    Sibling targets (blockdoc, xsd) and domain SCAD are out of scope.
+  </documentation>
   <references>
     <see type="fbdocumentation:ArchitectureOverview" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:LayerSeparation>

package/blocks/org/blockml/bml/target/fatblock/documentation/NamespaceMergeRules.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — NamespaceMergeRules
-  FQN: org.blockml.bml.target.fatblock.documentation.NamespaceMergeRules
--->
-<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
-                      "
+<!--FatBlock Documentation — NamespaceMergeRules
+  FQN: org.blockml.bml.target.fatblock.documentation.NamespaceMergeRules-->
+<fbdocumentation:NamespaceMergeRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,20 +17,22 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>NamespaceMergeRules</name>
-  <type>fbdocumentation:NamespaceMergeRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>Stage-2 namespace merge before emit (FB9–FB11, D2)</is>
-
-  <documentation>FB9: merge host bindings first, then each embed source in candidate order.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Stage-2 namespace merge before emit (FB9–FB11, D2)
+  </is>
+  <documentation>
+    FB9: merge host bindings first, then each embed source in candidate order.
     FB11: missing bindings default empty prefix to http://blockml.org/bml.
     FB10: same prefix, different URI → BML_NAMESPACE_PREFIX_COLLISION (no silent rewrite;
     no inventing new prefixes). First writer wins for new prefixes.
-
+    
     Aligns with docs/19 Definition / bml:xml D2 consumer rules. Serializer may still emit
-    BML_NAMESPACE_UNBOUND if a QName lacks a binding after merge.</documentation>
+    BML_NAMESPACE_UNBOUND if a QName lacks a binding after merge.
+  </documentation>
   <references>
     <see type="fbdocumentation:OutputLayout" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:NamespaceMergeRules>

package/blocks/org/blockml/bml/target/fatblock/documentation/OutputLayout.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — OutputLayout
-  FQN: org.blockml.bml.target.fatblock.documentation.OutputLayout
--->
-<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
-                      "
+<!--FatBlock Documentation — OutputLayout
+  FQN: org.blockml.bml.target.fatblock.documentation.OutputLayout-->
+<fbdocumentation:OutputLayout xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,18 +17,20 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>OutputLayout</name>
-  <type>fbdocumentation:OutputLayout</type>
-  <baseType>core:Documentation</baseType>
-  <is>Output file naming and host write path</is>
-
-  <documentation>FB18 FatOutputBasename: host FQN → {fqn}.fat.bml.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Output file naming and host write path
+  </is>
+  <documentation>
+    FB18 FatOutputBasename: host FQN → {fqn}.fat.bml.
     Target returns relative path only; CLI writes to the invocation directory or --out.
-
+    
     Single file per render. Content is canonical BML XML from SerializeFatDocument
-    (indent 2, no XML declaration by serializer defaults).</documentation>
+    (indent 2, no XML declaration by serializer defaults).
+  </documentation>
   <references>
     <see type="fbdocumentation:Diagnostics" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:OutputLayout>

package/blocks/org/blockml/bml/target/fatblock/documentation/PackageOwnership.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — PackageOwnership
-  FQN: org.blockml.bml.target.fatblock.documentation.PackageOwnership
--->
-<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
-                      "
+<!--FatBlock Documentation — PackageOwnership
+  FQN: org.blockml.bml.target.fatblock.documentation.PackageOwnership-->
+<fbdocumentation:PackageOwnership xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,26 +17,28 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PackageOwnership</name>
-  <type>fbdocumentation:PackageOwnership</type>
-  <baseType>core:Documentation</baseType>
-  <is>Who owns FatBlock vs CLI vs BOM</is>
-
-  <documentation>@blockml/fatblock-target owns: this BML library; TypeScript assemble/filter/merge/emit;
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Who owns FatBlock vs CLI vs BOM
+  </is>
+  <documentation>
+    @blockml/fatblock-target owns: this BML library; TypeScript assemble/filter/merge/emit;
     FatBlockOptions; BML_FATBLOCK_* diagnostics; output basename algorithm.
-
+    
     @blockml/cli owns: --src / --include / --out; default host from package.json
     blockml.library; TypeRegistry from the package library graph plus core; writing
     {hostFqn}.fat.bml at the invocation directory; exit codes.
     See org.blockml.bml.cli.documentation.CompileCommand.
-
+    
     @blockml/bom owns: embeddedBlocks shape and language invariants.
-
+    
     @blockml/serializer owns: XML emit of the assembled BomDocument.
-
-    @blockml/compiler owns: RenderTarget contract and document compile scope.</documentation>
+    
+    @blockml/compiler owns: RenderTarget contract and document compile scope.
+  </documentation>
   <references>
     <see type="fbdocumentation:ScopeExclusions" relation="ReadNext" />
   </references>
-
-</block>
+</fbdocumentation:PackageOwnership>

package/blocks/org/blockml/bml/target/fatblock/documentation/PublicApi.bml

@@ -1,12 +1,6 @@
-<!--
-  FatBlock Documentation — PublicApi
-  FQN: org.blockml.bml.target.fatblock.documentation.PublicApi
--->
-<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
-                      "
+<!--FatBlock Documentation — PublicApi
+  FQN: org.blockml.bml.target.fatblock.documentation.PublicApi-->
+<fbdocumentation:PublicApi xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -23,12 +17,14 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PublicApi</name>
-  <type>fbdocumentation:PublicApi</type>
-  <baseType>core:Documentation</baseType>
-  <is>Public TypeScript and capability surface</is>
-
-  <documentation>Package @blockml/fatblock-target exports:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Public TypeScript and capability surface
+  </is>
+  <documentation>
+    Package @blockml/fatblock-target exports:
     • FatBlockTarget — RenderTarget; name fatblock; accepts document;
       validateRequest; render → FatBlockRenderOutput
     • FatBlockOptions / DEFAULT_FATBLOCK_OPTIONS / resolveFatBlockOptions
@@ -36,13 +32,13 @@
     • collectCandidateFqns / rootFqnsByFilePath
     • filterByIncludes / matchesIncludePattern
     • mergeNamespaceBindings / cloneBlockDefinition / fatOutputBasename
-
-    BML: fbcap:Render, ValidateRequest, AssembleFatDocument, api/FatBlockOptions.</documentation>
+    
+    BML: fbcap:Render, ValidateRequest, AssembleFatDocument, api/FatBlockOptions.
+  </documentation>
   <references>
     <see type="fbdocumentation:CandidateCollection" relation="ReadNext" />
     <see type="fbcap:Render" relation="Defines" />
     <see type="fbapi:FatBlockOptions" relation="Defines" />
     <see type="fbcap:AssembleFatDocument" relation="Defines" />
   </references>
-
-</block>
+</fbdocumentation:PublicApi>