@blockml/xsd-target 0.9.4 → 0.9.6

package/blocks/org/blockml/bml/target/xsd/capability/ExtraElementNames.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Capability — ExtraElementNames
-  FQN: org.blockml.bml.target.xsd.capability.ExtraElementNames
--->
-<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
-                      "
+<!--XSD Capability — ExtraElementNames
+  FQN: org.blockml.bml.target.xsd.capability.ExtraElementNames-->
+<xsdcap:ExtraElementNames xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,24 +14,28 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>ExtraElementNames</name>
-  <type>xsdcap:ExtraElementNames</type>
-  <baseType>core:Capability</baseType>
-  <is>Collect extra particle names from meta Definition blocks</is>
-
-  <documentation>XSD9/XSD11: walk META_DEFINITION_FQNS if present; recurse members and subBlocks; keep names where MemberPrefersElement; unique sort; exclude D1 identity and container names.</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Collect extra particle names from meta Definition blocks
+  </is>
+  <documentation>
+    XSD9/XSD11: walk META_DEFINITION_FQNS if present; recurse members and subBlocks; keep names where MemberPrefersElement; unique sort; exclude D1 identity and container names.
+  </documentation>
   <references>
     <see type="xsdconfig:XsdConstants" relation="SeeAlso" />
   </references>
-
   <properties>
     <typeRegistry type="type:Text">
-      <documentation>TypeRegistry. (required)</documentation>
+      <documentation>
+        TypeRegistry. (required)
+      </documentation>
     </typeRegistry>
     <result type="type:Text">
-      <documentation>Sorted unique element names. (required)</documentation>
+      <documentation>
+        Sorted unique element names. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</xsdcap:ExtraElementNames>

package/blocks/org/blockml/bml/target/xsd/capability/MemberPrefersElement.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Capability — MemberPrefersElement
-  FQN: org.blockml.bml.target.xsd.capability.MemberPrefersElement
--->
-<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
-                      "
+<!--XSD Capability — MemberPrefersElement
+  FQN: org.blockml.bml.target.xsd.capability.MemberPrefersElement-->
+<xsdcap:MemberPrefersElement xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,24 +14,28 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>MemberPrefersElement</name>
-  <type>xsdcap:MemberPrefersElement</type>
-  <baseType>core:Capability</baseType>
-  <is>Decide whether a member becomes an element particle</is>
-
-  <documentation>XSD10: true if xmlRendering.kinds includes element or raw includes element; false if sole kind attribute or raw equals attribute; aggregations and associations true; default true. Attribute-only members omitted from schema.</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Decide whether a member becomes an element particle
+  </is>
+  <documentation>
+    XSD10: true if xmlRendering.kinds includes element or raw includes element; false if sole kind attribute or raw equals attribute; aggregations and associations true; default true. Attribute-only members omitted from schema.
+  </documentation>
   <references>
     <see type="xsddocumentation:ParticleMappingRules" relation="SeeAlso" />
   </references>
-
   <properties>
     <member type="type:Text">
-      <documentation>MemberDefinition. (required)</documentation>
+      <documentation>
+        MemberDefinition. (required)
+      </documentation>
     </member>
     <result type="type:Boolean">
-      <documentation>true if emit as xs:element particle. (required)</documentation>
+      <documentation>
+        true if emit as xs:element particle. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</xsdcap:MemberPrefersElement>

package/blocks/org/blockml/bml/target/xsd/capability/Render.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Capability — Render
-  FQN: org.blockml.bml.target.xsd.capability.Render
--->
-<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
-                      "
+<!--XSD Capability — Render
+  FQN: org.blockml.bml.target.xsd.capability.Render-->
+<xsdcap:Render xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,28 +14,34 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>Render</name>
-  <type>xsdcap:Render</type>
-  <baseType>core:Capability</baseType>
-  <is>Public RenderTarget entry: TypeRegistry to XSD files and catalog</is>
-
-  <documentation>XSD1–XSD3: name xsd; accepts library|corpus|auto; always emit bml.xsd. XSD14–XSD15: always rootFiles catalog.xml; if emitDomainSchemas append types.xsd and service.xsd with catalog entries. Uses session typeRegistry and outputBasePath.</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Public RenderTarget entry: TypeRegistry to XSD files and catalog
+  </is>
+  <documentation>
+    XSD1–XSD3: name xsd; accepts library|corpus|auto; always emit bml.xsd. XSD14–XSD15: always rootFiles catalog.xml; if emitDomainSchemas append types.xsd and service.xsd with catalog entries. Uses session typeRegistry and outputBasePath.
+  </documentation>
   <references>
     <see type="xsddocumentation:PublicApi" relation="SeeAlso" />
     <see type="xsdcap:EmitBlockXsd" relation="SeeAlso" />
   </references>
-
   <properties>
     <request type="type:Text">
-      <documentation>CompileRequest with targetOptions. (required)</documentation>
+      <documentation>
+        CompileRequest with targetOptions. (required)
+      </documentation>
     </request>
     <renderContext type="type:Text">
-      <documentation>RenderContext. (required)</documentation>
+      <documentation>
+        RenderContext. (required)
+      </documentation>
     </renderContext>
     <result type="xsdapi:XsdRenderOutput">
-      <documentation>files and rootFiles. (required)</documentation>
+      <documentation>
+        files and rootFiles. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</xsdcap:Render>

package/blocks/org/blockml/bml/target/xsd/capability/ResolveOptions.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Capability — ResolveOptions
-  FQN: org.blockml.bml.target.xsd.capability.ResolveOptions
--->
-<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
-                      "
+<!--XSD Capability — ResolveOptions
+  FQN: org.blockml.bml.target.xsd.capability.ResolveOptions-->
+<xsdcap:ResolveOptions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,25 +14,29 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>ResolveOptions</name>
-  <type>xsdcap:ResolveOptions</type>
-  <baseType>core:Capability</baseType>
-  <is>Merge opaque targetOptions into required XsdOptions</is>
-
-  <documentation>XSD15/XSD16: defaults includeNonExported=true, emitDomainSchemas=true. includeNonExported has no V1 emit effect.</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Merge opaque targetOptions into required XsdOptions
+  </is>
+  <documentation>
+    XSD15/XSD16: defaults includeNonExported=true, emitDomainSchemas=true. includeNonExported has no V1 emit effect.
+  </documentation>
   <references>
     <see type="xsddocumentation:PublicApi" relation="SeeAlso" />
     <see type="xsdconfig:DefaultXsdOptions" relation="SeeAlso" />
   </references>
-
   <properties>
     <targetOptions type="type:Text">
-      <documentation>Opaque CompileRequest.targetOptions. (optional)</documentation>
+      <documentation>
+        Opaque CompileRequest.targetOptions. (optional)
+      </documentation>
     </targetOptions>
     <result type="xsdapi:XsdOptions">
-      <documentation>Fully resolved options. (required)</documentation>
+      <documentation>
+        Fully resolved options. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</xsdcap:ResolveOptions>

package/blocks/org/blockml/bml/target/xsd/capability/VocabularyElements.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Capability — VocabularyElements
-  FQN: org.blockml.bml.target.xsd.capability.VocabularyElements
--->
-<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
-                      "
+<!--XSD Capability — VocabularyElements
+  FQN: org.blockml.bml.target.xsd.capability.VocabularyElements-->
+<xsdcap:VocabularyElements xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,23 +14,30 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>VocabularyElements</name>
-  <type>xsdcap:VocabularyElements</type>
-  <baseType>core:Capability</baseType>
-  <is>List sorted short names under an FQN prefix</is>
-
-  <documentation>Shared helper for types/service emit: filter registry.keys by prefix; take last segment after dot; sort.</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    List sorted short names under an FQN prefix
+  </is>
+  <documentation>
+    Shared helper for types/service emit: filter registry.keys by prefix; take last segment after dot; sort.
+  </documentation>
   <properties>
     <typeRegistry type="type:Text">
-      <documentation>TypeRegistry. (required)</documentation>
+      <documentation>
+        TypeRegistry. (required)
+      </documentation>
     </typeRegistry>
     <prefix type="type:Text">
-      <documentation>FQN prefix. (required)</documentation>
+      <documentation>
+        FQN prefix. (required)
+      </documentation>
     </prefix>
     <result type="type:Text">
-      <documentation>Sorted short names. (required)</documentation>
+      <documentation>
+        Sorted short names. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</xsdcap:VocabularyElements>

package/blocks/org/blockml/bml/target/xsd/config/DefaultXsdOptions.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Config — DefaultXsdOptions
-  FQN: org.blockml.bml.target.xsd.config.DefaultXsdOptions
--->
-<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
-                      "
+<!--XSD Config — DefaultXsdOptions
+  FQN: org.blockml.bml.target.xsd.config.DefaultXsdOptions-->
+<xsdconfig:DefaultXsdOptions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,14 +14,22 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>DefaultXsdOptions</name>
-  <type>xsdconfig:DefaultXsdOptions</type>
-  <baseType>xsd:XsdType</baseType>
-  <is>Defaults applied by ResolveOptions</is>
-
+  <baseType>
+    xsd:XsdType
+  </baseType>
+  <is>
+    Defaults applied by ResolveOptions
+  </is>
   <properties>
-    <includeNonExported type="type:Boolean"><documentation>true</documentation></includeNonExported>
-    <emitDomainSchemas type="type:Boolean"><documentation>true</documentation></emitDomainSchemas>
+    <includeNonExported type="type:Boolean">
+      <documentation>
+        true
+      </documentation>
+    </includeNonExported>
+    <emitDomainSchemas type="type:Boolean">
+      <documentation>
+        true
+      </documentation>
+    </emitDomainSchemas>
   </properties>
-
-</block>
+</xsdconfig:DefaultXsdOptions>

package/blocks/org/blockml/bml/target/xsd/config/XsdConstants.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Config — XsdConstants
-  FQN: org.blockml.bml.target.xsd.config.XsdConstants
--->
-<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
-                      "
+<!--XSD Config — XsdConstants
+  FQN: org.blockml.bml.target.xsd.config.XsdConstants-->
+<xsdconfig:XsdConstants xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -20,23 +14,65 @@
   xmlns:xsddocumentation="org.blockml.bml.target.xsd.documentation"
   xmlns:type="org.blockml.bml.type">
 
-  <name>XsdConstants</name>
-  <type>xsdconfig:XsdConstants</type>
-  <baseType>xsd:XsdType</baseType>
-  <is>Well-known namespace URIs, FQN prefixes, and D1 particle lists</is>
-
-  <documentation>XSD4–XSD9 constants. D1 identity and container element name lists are normative for V1 bml.xsd emit.</documentation>
+  <baseType>
+    xsd:XsdType
+  </baseType>
+  <is>
+    Well-known namespace URIs, FQN prefixes, and D1 particle lists
+  </is>
+  <documentation>
+    XSD4–XSD9 constants. D1 identity and container element name lists are normative for V1 bml.xsd emit.
+  </documentation>
   <properties>
-    <BML_DOCUMENT_NS type="type:Text"><documentation>http://blockml.org/bml</documentation></BML_DOCUMENT_NS>
-    <BML_TYPES_NS type="type:Text"><documentation>http://blockml.org/schema/types</documentation></BML_TYPES_NS>
-    <BML_SERVICE_NS type="type:Text"><documentation>http://blockml.org/schema/service</documentation></BML_SERVICE_NS>
-    <TYPE_FQN_PREFIX type="type:Text"><documentation>org.blockml.bml.type.</documentation></TYPE_FQN_PREFIX>
-    <SERVICE_FQN_PREFIX type="type:Text"><documentation>org.blockml.bml.service.</documentation></SERVICE_FQN_PREFIX>
-    <D1_IDENTITY_ELEMENTS type="type:Text"><documentation>Hardcoded identity particle names including both isNot and isnot.</documentation></D1_IDENTITY_ELEMENTS>
-    <D1_CONTAINER_ELEMENTS type="type:Text"><documentation>Hardcoded container particle names.</documentation></D1_CONTAINER_ELEMENTS>
-    <META_DEFINITION_FQNS type="type:Text"><documentation>Definition FQNs walked for extra element names.</documentation></META_DEFINITION_FQNS>
-    <REGISTRY_NAME type="type:Text"><documentation>xsd</documentation></REGISTRY_NAME>
-    <ACCEPTS type="type:Text"><documentation>library, corpus, auto</documentation></ACCEPTS>
+    <BML_DOCUMENT_NS type="type:Text">
+      <documentation>
+        http://blockml.org/bml
+      </documentation>
+    </BML_DOCUMENT_NS>
+    <BML_TYPES_NS type="type:Text">
+      <documentation>
+        http://blockml.org/schema/types
+      </documentation>
+    </BML_TYPES_NS>
+    <BML_SERVICE_NS type="type:Text">
+      <documentation>
+        http://blockml.org/schema/service
+      </documentation>
+    </BML_SERVICE_NS>
+    <TYPE_FQN_PREFIX type="type:Text">
+      <documentation>
+        org.blockml.bml.type.
+      </documentation>
+    </TYPE_FQN_PREFIX>
+    <SERVICE_FQN_PREFIX type="type:Text">
+      <documentation>
+        org.blockml.bml.service.
+      </documentation>
+    </SERVICE_FQN_PREFIX>
+    <D1_IDENTITY_ELEMENTS type="type:Text">
+      <documentation>
+        Hardcoded identity particle names including both isNot and isnot.
+      </documentation>
+    </D1_IDENTITY_ELEMENTS>
+    <D1_CONTAINER_ELEMENTS type="type:Text">
+      <documentation>
+        Hardcoded container particle names.
+      </documentation>
+    </D1_CONTAINER_ELEMENTS>
+    <META_DEFINITION_FQNS type="type:Text">
+      <documentation>
+        Definition FQNs walked for extra element names.
+      </documentation>
+    </META_DEFINITION_FQNS>
+    <REGISTRY_NAME type="type:Text">
+      <documentation>
+        xsd
+      </documentation>
+    </REGISTRY_NAME>
+    <ACCEPTS type="type:Text">
+      <documentation>
+        library, corpus, auto
+      </documentation>
+    </ACCEPTS>
   </properties>
-
-</block>
+</xsdconfig:XsdConstants>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — ArchitectureOverview
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — ArchitectureOverview
+  FQN: org.blockml.bml.target.xsd.documentation.ArchitectureOverview-->
+<xsddocumentation:ArchitectureOverview xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,24 +16,26 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ArchitectureOverview</name>
-  <type>xsddocumentation:ArchitectureOverview</type>
-  <baseType>core:Documentation</baseType>
-  <is>Modules and data flow</is>
-
-  <documentation>Public entry: XsdTarget.render → ResolveOptions then emit helpers.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Modules and data flow
+  </is>
+  <documentation>
+    Public entry: XsdTarget.render → ResolveOptions then emit helpers.
     Modules map 1:1 to capabilities:
     options.ts → ResolveOptions; constants.ts → XsdConstants;
     emit-block-xsd.ts → EmitBlockXsd / MemberPrefersElement / ExtraElementNames;
     emit-types-xsd.ts / emit-service-xsd.ts → EmitTypesXsd / EmitServiceXsd / VocabularyElements;
     emit-catalog-xml.ts → EmitCatalogXml / CatalogRelativePath;
     xsd-target.ts → Render.
-
+    
     Accepts library|corpus|auto (XSD2). Always emits bml.xsd (XSD1/XSD3). Domain schemas
-    gated by emitDomainSchemas (XSD15). Catalog always in rootFiles (XSD14).</documentation>
+    gated by emitDomainSchemas (XSD15). Catalog always in rootFiles (XSD14).
+  </documentation>
   <references>
     <see type="xsddocumentation:V1Scope" relation="ReadNext" />
     <see type="xsdcap:Render" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:ArchitectureOverview>

package/blocks/org/blockml/bml/target/xsd/documentation/CatalogAndOutputLayout.bml

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — CatalogAndOutputLayout
-  FQN: org.blockml.bml.target.xsd.documentation.CatalogAndOutputLayout
--->
-<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
-                      "
+<!--XSD Documentation — CatalogAndOutputLayout
+  FQN: org.blockml.bml.target.xsd.documentation.CatalogAndOutputLayout-->
+<xsddocumentation:CatalogAndOutputLayout xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,24 +16,26 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>CatalogAndOutputLayout</name>
-  <type>xsddocumentation:CatalogAndOutputLayout</type>
-  <baseType>core:Documentation</baseType>
-  <is>Output files and OASIS catalog (XSD14)</is>
-
-  <documentation>files[]: always bml.xsd; if emitDomainSchemas also types.xsd and service.xsd
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Output files and OASIS catalog (XSD14)
+  </is>
+  <documentation>
+    files[]: always bml.xsd; if emitDomainSchemas also types.xsd and service.xsd
     (paths relative to session outputBasePath / CLI default schemas/).
     rootFiles[]: always catalog.xml at project root (CLI writes separately).
-
+    
     XSD14: OASIS xmlns urn:oasis:names:tc:entity:xmlns:xml:catalog;
     one uri per CatalogEntry (name=namespaceUri, uri=CatalogRelativePath).
     CatalogRelativePath: normalize slashes, strip trailing, return ./outDir/file.
-
-    IDE catalog usage is host/docs 15; generation rules live here.</documentation>
+    
+    IDE catalog usage is host/docs 15; generation rules live here.
+  </documentation>
   <references>
     <see type="xsddocumentation:Diagnostics" relation="ReadNext" />
     <see type="xsdcap:EmitCatalogXml" relation="SeeAlso" />
     <see type="cli:Library" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:CatalogAndOutputLayout>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — DesignDecisions
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — DesignDecisions
+  FQN: org.blockml.bml.target.xsd.documentation.DesignDecisions-->
+<xsddocumentation:DesignDecisions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,14 +16,15 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>DesignDecisions</name>
-  <type>xsddocumentation:DesignDecisions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Normative XSD decisions XSD1–XSD18</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Normative XSD decisions XSD1–XSD18
+  </is>
   <documentation>
     # Normative XSD decisions XSD1–XSD18
-
+    
     - XSD1 Always emit bml.xsd.
     - XSD2 accepts library|corpus|auto; registry name xsd.
     - XSD3 Render uses session typeRegistry and outputBasePath.
@@ -49,5 +44,4 @@
   <references>
     <see type="xsddocumentation:PackageOwnership" relation="ReadNext" />
   </references>
-
-</block>
+</xsddocumentation:DesignDecisions>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — Diagnostics
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — Diagnostics
+  FQN: org.blockml.bml.target.xsd.documentation.Diagnostics-->
+<xsddocumentation:Diagnostics xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,23 +16,23 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Diagnostics</name>
-  <type>xsddocumentation:Diagnostics</type>
-  <baseType>core:Documentation</baseType>
-  <is>Emit path has no package-local diagnostics</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Emit path has no package-local diagnostics
+  </is>
   <documentation>
     # Emit path has no package-local diagnostics
-
+    
     V1 XSD target emits without package diagnostics codes. Failures surface as host/CLI
     or empty/malformed output only if upstream session is broken.
-
+    
     Generated schema is non-authoritative; CLI validate does not invoke this target.
-
+    
     Scope mismatch for accepts is compiler/CLI (BML_TARGET_SCOPE_MISMATCH).
   </documentation>
   <references>
     <see type="xsddocumentation:DesignDecisions" relation="ReadNext" />
   </references>
-
-</block>
+</xsddocumentation:Diagnostics>