@blockml/validator 0.9.4 → 0.9.5

package/blocks/org/blockml/bml/compiler/validator/documentation/PackageOwnership.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Documentation — PackageOwnership
-  FQN: org.blockml.bml.compiler.validator.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
-                      "
+<!--Validator Documentation — PackageOwnership
+  FQN: org.blockml.bml.compiler.validator.documentation.PackageOwnership-->
+<valdocumentation:PackageOwnership xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -22,30 +16,30 @@
   xmlns:valcap="org.blockml.bml.compiler.validator.capability"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation"
-  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
->
-
-  <name>PackageOwnership</name>
-  <type>valdocumentation:PackageOwnership</type>
-  <baseType>core:Documentation</baseType>
-  <is>Toolchain package responsibilities for validation</is>
-
-  <documentation>@blockml/validator — validate() orchestration, style catalog, ValidateResult assembly.
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation">
+
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Toolchain package responsibilities for validation
+  </is>
+  <documentation>
+    @blockml/validator — validate() orchestration, style catalog, ValidateResult assembly.
     Owns this BML library including org.blockml.bml.compiler.validator.style.*.
-
+    
     @blockml/bom — Urmodell types, ValidateOptions/ValidateResult (B26), Diagnostic.
     Validator consumes; does not redefine.
-
+    
     @blockml/framework — TypeRegistry, forkBom, validateTypes, validateConstraints,
     bootstrapTypeRegistry. Validator delegates all semantic work here.
-
+    
     @blockml/parser — BML → BomDocument; used indirectly via framework bootstrap.
-
-    @blockml/cli — validate command host; may inject TypeRegistry or bootstrap paths.</documentation>
-
+    
+    @blockml/cli — validate command host; may inject TypeRegistry or bootstrap paths.
+  </documentation>
   <references>
     <see type="valdocumentation:ScopeExclusions" relation="ReadNext" />
     <see type="bomdocumentation:PackageOwnership" relation="SeeAlso" />
   </references>
-
-</block>
+</valdocumentation:PackageOwnership>

package/blocks/org/blockml/bml/compiler/validator/documentation/PublicApi.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Documentation — PublicApi
-  FQN: org.blockml.bml.compiler.validator.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
-                      "
+<!--Validator Documentation — PublicApi
+  FQN: org.blockml.bml.compiler.validator.documentation.PublicApi-->
+<valdocumentation:PublicApi xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -23,30 +17,32 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PublicApi</name>
-  <type>valdocumentation:PublicApi</type>
-  <baseType>core:Documentation</baseType>
-  <is>validate() entry point (B26)</is>
-
-  <documentation>    validate(document: BomDocument, options?: ValidateOptions): ValidateResult
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    validate() entry point (B26)
+  </is>
+  <documentation>
+    validate(document: BomDocument, options?: ValidateOptions): ValidateResult
     validateStyle(document: BomDocument): Diagnostic[]
-
+    
     ValidateOptions (owned by @blockml/bom):
     • typeRegistry — pre-built TypeRegistryReader / TypeRegistry instance (optional)
     • bootstrapPaths — corpus roots when bootstrapping (optional)
     • continueOnError — default true; when false, omit pragmaticModel on failure
-
+    
     ValidateResult (owned by @blockml/bom):
     • pragmaticModel — forked BomDocument when validation completes or continueOnError
     • diagnostics — Diagnostic[]
     • success — false if any error-severity diagnostic
-
+    
     Style: validateStyle runs after semantic checks. Catalog SSOT lives under
     org.blockml.bml.compiler.validator.style.*. Warnings and recommendations do not
     fail success.
-
-    Sync only; does not throw on validation errors. Host decides abort policy.</documentation>
-
+    
+    Sync only; does not throw on validation errors. Host decides abort policy.
+  </documentation>
   <references>
     <see type="bomapi:ValidateOptions" relation="Defines" />
     <see type="bomapi:ValidateResult" relation="Defines" />
@@ -54,5 +50,4 @@
     <see type="valcap:ValidateStyle" relation="Defines" />
     <see type="valdocumentation:DesignDecisions" relation="ReadNext" />
   </references>
-
-</block>
+</valdocumentation:PublicApi>

package/blocks/org/blockml/bml/compiler/validator/documentation/ScopeExclusions.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Documentation — ScopeExclusions
-  FQN: org.blockml.bml.compiler.validator.documentation.ScopeExclusions
--->
-<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
-                      "
+<!--Validator Documentation — ScopeExclusions
+  FQN: org.blockml.bml.compiler.validator.documentation.ScopeExclusions-->
+<valdocumentation:ScopeExclusions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -23,13 +17,15 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ScopeExclusions</name>
-  <type>valdocumentation:ScopeExclusions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Explicit out-of-scope for the validator package</is>
-
-  <documentation>Out of scope for @blockml/validator:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Explicit out-of-scope for the validator package
+  </is>
+  <documentation>
+    Out of scope for @blockml/validator:
+    
     • TypeRegistry implementation — @blockml/framework
     • Individual semantic validation rules — @blockml/framework (validateTypes, validateEmbeddedBlocks,
       validateInstances, validatePresets, validateVisibility, validateReadOnly, validateConstraints)
@@ -40,12 +36,11 @@
     • Render target emit / compile — @blockml/compiler
     • CLI file I/O — @blockml/cli
     • Language BML corpus — @blockml/core (npm)
-
+    
     In scope: validate() orchestration on BomDocument with framework utilities and the
-    style catalog.</documentation>
-
+    style catalog.
+  </documentation>
   <references>
     <see type="valdocumentation:Introduction" relation="SeeAlso" />
   </references>
-
-</block>
+</valdocumentation:ScopeExclusions>

package/blocks/org/blockml/bml/compiler/validator/documentation/ValidationPipeline.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Documentation — ValidationPipeline
-  FQN: org.blockml.bml.compiler.validator.documentation.ValidationPipeline
--->
-<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
-                      "
+<!--Validator Documentation — ValidationPipeline
+  FQN: org.blockml.bml.compiler.validator.documentation.ValidationPipeline-->
+<valdocumentation:ValidationPipeline xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -23,13 +17,15 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ValidationPipeline</name>
-  <type>valdocumentation:ValidationPipeline</type>
-  <baseType>core:Documentation</baseType>
-  <is>validate() orchestration steps</is>
-
-  <documentation>validate(document, options?) pipeline (packages/validator/src/validate.ts):
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    validate() orchestration steps
+  </is>
+  <documentation>
+    validate(document, options?) pipeline (packages/validator/src/validate.ts):
+    
     1. Resolve TypeRegistry — options.typeRegistry if instanceof TypeRegistry,
        else bootstrapTypeRegistry({ paths, libraryPaths, rootDir })
     2. forkBom(document) → pragmaticModel (structuredClone working copy)
@@ -45,17 +41,16 @@
     12. validateStyle(pragmaticModel) → append warning/recommendation diagnostics
     13. success = no diagnostic with severity === "error"
     14. Return ValidateResult { pragmaticModel?, diagnostics, success }
-
+    
     When continueOnError === false and success === false, pragmaticModel is omitted
     from the result (early return with diagnostics only).
-
+    
     Out of scope in this pipeline: SCAD/MachineBlocks Stage-3 render validation;
-    MemberGroups axis constraints (MB-only).</documentation>
-
+    MemberGroups axis constraints (MB-only).
+  </documentation>
   <references>
     <see type="valdocumentation:PublicApi" relation="ReadNext" />
     <see type="valcap:Validate" relation="Defines" />
     <see type="valcap:ValidateStyle" relation="SeeAlso" />
   </references>
-
-</block>
+</valdocumentation:ValidationPipeline>

package/blocks/org/blockml/bml/compiler/validator/documentation/ValidityContract.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Documentation — ValidityContract
-  FQN: org.blockml.bml.compiler.validator.documentation.ValidityContract
--->
-<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
-                      "
+<!--Validator Documentation — ValidityContract
+  FQN: org.blockml.bml.compiler.validator.documentation.ValidityContract-->
+<valdocumentation:ValidityContract xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,33 +18,34 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ValidityContract</name>
-  <type>valdocumentation:ValidityContract</type>
-  <baseType>core:Documentation</baseType>
-  <is>What counts as valid BlockML without XSD</is>
-
-  <documentation>valid BlockML = well-formed XML + valid BML structure + valid BML semantics.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What counts as valid BlockML without XSD
+  </is>
+  <documentation>
+    valid BlockML = well-formed XML + valid BML structure + valid BML semantics.
+    
     CLI blockml validate and LSP analyzeDocument consume the same parse + validate engine.
     Generated XSD is a non-authoritative render-target projection and is not consulted.
-
+    
     Severity: error = not valid BlockML; warning = valid but problematic (deprecation
     or mechanical style); recommendation = quality improvement; info = hint.
     Unknown element, attribute, member, type, block, or missing library is error.
-
+    
     Semantic checks (this package / framework): every type FQN must resolve in the
     TypeRegistry or be a well-known primitive; instance typeFqn and memberValues keys
     must match effective members. Unresolved references are errors. A missing library
     is BML_LIBRARY_RESOLVE_ERROR — analogous to a Java class without its Maven artifact.
-
+    
     Structural/semantic errors are node-local: they set success=false but keep the BOM
     (preserve-on-error). XML syntax errors may yield document null.
-
-    Unknown instance members stay in memberValues plus BML_UNKNOWN_PROPERTY error.</documentation>
-
+    
+    Unknown instance members stay in memberValues plus BML_UNKNOWN_PROPERTY error.
+  </documentation>
   <references>
     <see type="pardocumentation:StructuralGrammar" relation="SeeAlso" />
     <see type="valdocumentation:ValidationPipeline" relation="ReadNext" />
   </references>
-
-</block>
+</valdocumentation:ValidityContract>

package/blocks/org/blockml/bml/compiler/validator/style/PreferCDataWhenNeedsEscape.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Style Check — PreferCDataWhenNeedsEscape
-  FQN: org.blockml.bml.compiler.validator.style.PreferCDataWhenNeedsEscape
--->
-<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
-                      "
+<!--Validator Style Check — PreferCDataWhenNeedsEscape
+  FQN: org.blockml.bml.compiler.validator.style.PreferCDataWhenNeedsEscape-->
+<valstyle:PreferCDataWhenNeedsEscape xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
@@ -14,14 +8,16 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:valstyle="org.blockml.bml.compiler.validator.style">
 
-  <name>PreferCDataWhenNeedsEscape</name>
-  <type>valstyle:PreferCDataWhenNeedsEscape</type>
-  <baseType>valstyle:StyleCheck</baseType>
-  <is>Recommend CDATA when documentation text contains and or less-than</is>
-
-  <documentation><![CDATA[
+  <baseType>
+    valstyle:StyleCheck
+  </baseType>
+  <is>
+    Recommend CDATA when documentation text contains and or less-than
+  </is>
+  <documentation>
+    <![CDATA[
     Matches block-level documentation prose whose text contains & or <
     and authoredCharacterDataForm is not cdata.
-  ]]></documentation>
-
-</block>
+    ]]>
+  </documentation>
+</valstyle:PreferCDataWhenNeedsEscape>

package/blocks/org/blockml/bml/compiler/validator/style/PreferEmptyElementSelfClosing.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Style Check — PreferEmptyElementSelfClosing
-  FQN: org.blockml.bml.compiler.validator.style.PreferEmptyElementSelfClosing
--->
-<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
-                      "
+<!--Validator Style Check — PreferEmptyElementSelfClosing
+  FQN: org.blockml.bml.compiler.validator.style.PreferEmptyElementSelfClosing-->
+<valstyle:PreferEmptyElementSelfClosing xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
@@ -14,12 +8,14 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:valstyle="org.blockml.bml.compiler.validator.style">
 
-  <name>PreferEmptyElementSelfClosing</name>
-  <type>valstyle:PreferEmptyElementSelfClosing</type>
-  <baseType>valstyle:StyleCheck</baseType>
-  <is>Warn when an empty see reference is authored as a paired tag</is>
-
-  <documentation>Matches DocumentationReference with empty context and authoredEmptyElementForm paired
-    (see open-close with no body). Preferred form is self-closing.</documentation>
-
-</block>
+  <baseType>
+    valstyle:StyleCheck
+  </baseType>
+  <is>
+    Warn when an empty see reference is authored as a paired tag
+  </is>
+  <documentation>
+    Matches DocumentationReference with empty context and authoredEmptyElementForm paired
+    (see open-close with no body). Preferred form is self-closing.
+  </documentation>
+</valstyle:PreferEmptyElementSelfClosing>

package/blocks/org/blockml/bml/compiler/validator/style/PreferMarkdownStructure.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Style Check — PreferMarkdownStructure
-  FQN: org.blockml.bml.compiler.validator.style.PreferMarkdownStructure
--->
-<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
-                      "
+<!--Validator Style Check — PreferMarkdownStructure
+  FQN: org.blockml.bml.compiler.validator.style.PreferMarkdownStructure-->
+<valstyle:PreferMarkdownStructure xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
@@ -14,12 +8,14 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:valstyle="org.blockml.bml.compiler.validator.style">
 
-  <name>PreferMarkdownStructure</name>
-  <type>valstyle:PreferMarkdownStructure</type>
-  <baseType>valstyle:StyleCheck</baseType>
-  <is>Recommend markdown structure for long block documentation</is>
-
-  <documentation>Matches block-level documentation longer than 280 characters with no blank
-    line, heading, or list marker. Short member documentation is out of scope.</documentation>
-
-</block>
+  <baseType>
+    valstyle:StyleCheck
+  </baseType>
+  <is>
+    Recommend markdown structure for long block documentation
+  </is>
+  <documentation>
+    Matches block-level documentation longer than 280 characters with no blank
+    line, heading, or list marker. Short member documentation is out of scope.
+  </documentation>
+</valstyle:PreferMarkdownStructure>

package/blocks/org/blockml/bml/compiler/validator/style/PreferOmitRedundantName.bml

@@ -0,0 +1,15 @@
+<!--
+  Validator Style Check — PreferOmitRedundantName
+  FQN: org.blockml.bml.compiler.validator.style.PreferOmitRedundantName
+-->
+<style:PreferOmitRedundantName
+  xmlns="http://blockml.org/bml"
+  xmlns:style="org.blockml.bml.compiler.validator.style">
+
+  <is>Warn when a preferred-form Block still declares a name child</is>
+
+  <documentation>Matches any preferred-form definition (root, Sub-Block, or embed)
+    that still authors a child name element. The tag already supplies the
+    name (doc:DocumentFormat).</documentation>
+
+</style:PreferOmitRedundantName>

package/blocks/org/blockml/bml/compiler/validator/style/PreferOmitRedundantType.bml

@@ -0,0 +1,15 @@
+<!--
+  Validator Style Check — PreferOmitRedundantType
+  FQN: org.blockml.bml.compiler.validator.style.PreferOmitRedundantType
+-->
+<style:PreferOmitRedundantType
+  xmlns="http://blockml.org/bml"
+  xmlns:style="org.blockml.bml.compiler.validator.style">
+
+  <is>Warn when a preferred-form Block still declares a type child</is>
+
+  <documentation>Matches any preferred-form definition (root, Sub-Block, or embed)
+    that still authors a child type element. The tag already supplies the
+    type, or the Sub-Block type is derived (doc:DocumentFormat).</documentation>
+
+</style:PreferOmitRedundantType>

package/blocks/org/blockml/bml/compiler/validator/style/PreferTypeAsTag.bml

@@ -0,0 +1,15 @@
+<!--
+  Validator Style Check — PreferTypeAsTag
+  FQN: org.blockml.bml.compiler.validator.style.PreferTypeAsTag
+-->
+<style:PreferTypeAsTag
+  xmlns="http://blockml.org/bml"
+  xmlns:style="org.blockml.bml.compiler.validator.style">
+
+  <is>Warn when a definition still uses the legacy block wrapper</is>
+
+  <documentation>Matches a BlockDefinition whose wrapperForm is block — the legacy
+    definition wrapper. Preferred form uses the type (root / embed) or name
+    (Sub-Block) as the element tag (doc:DocumentFormat).</documentation>
+
+</style:PreferTypeAsTag>

package/blocks/org/blockml/bml/compiler/validator/style/StyleCheck.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Style — StyleCheck
-  FQN: org.blockml.bml.compiler.validator.style.StyleCheck
--->
-<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
-                      "
+<!--Validator Style — StyleCheck
+  FQN: org.blockml.bml.compiler.validator.style.StyleCheck-->
+<valstyle:StyleCheck xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
@@ -14,14 +8,17 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:valstyle="org.blockml.bml.compiler.validator.style">
 
-  <name>StyleCheck</name>
-  <type>valstyle:StyleCheck</type>
-  <baseType>validator:ValidatorType</baseType>
-  <is>Abstract marker for a style-check interpreter kind</is>
-
-  <documentation>Concrete check types bind to a TypeScript interpreter in validateStyle.
-    Unknown check types emit BML_STYLE_UNKNOWN_CHECK (info) and are skipped.</documentation>
-
-  <abstract>true</abstract>
-
-</block>
+  <baseType>
+    validator:ValidatorType
+  </baseType>
+  <is>
+    Abstract marker for a style-check interpreter kind
+  </is>
+  <documentation>
+    Concrete check types bind to a TypeScript interpreter in validateStyle.
+    Unknown check types emit BML_STYLE_UNKNOWN_CHECK (info) and are skipped.
+  </documentation>
+  <abstract>
+    true
+  </abstract>
+</valstyle:StyleCheck>

package/blocks/org/blockml/bml/compiler/validator/style/StyleRule.bml

@@ -1,12 +1,6 @@
-<!--
-  Validator Style — StyleRule
-  FQN: org.blockml.bml.compiler.validator.style.StyleRule
--->
-<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
-                      "
+<!--Validator Style — StyleRule
+  FQN: org.blockml.bml.compiler.validator.style.StyleRule-->
+<valstyle:StyleRule xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomcommon="org.blockml.bml.bom.common"
@@ -17,37 +11,47 @@
   xmlns:valstyle="org.blockml.bml.compiler.validator.style"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>StyleRule</name>
-  <type>valstyle:StyleRule</type>
-  <baseType>validator:ValidatorType</baseType>
-  <is>Catalog entry for a BML authoring quality rule</is>
-
-  <documentation>SSOT for one style check. Concrete rules extend this type. validateStyle loads
+  <baseType>
+    validator:ValidatorType
+  </baseType>
+  <is>
+    Catalog entry for a BML authoring quality rule
+  </is>
+  <documentation>
+    SSOT for one style check. Concrete rules extend this type. validateStyle loads
     rule documents from this package blocks/ and dispatches on check type FQN.
-    Warnings and recommendations never set ValidateResult.success to false.</documentation>
-
+    Warnings and recommendations never set ValidateResult.success to false.
+  </documentation>
   <properties>
     <code type="type:Text">
-      <documentation>Diagnostic code, e.g. BML_STYLE_PREFER_CDATA. (required)</documentation>
+      <documentation>
+        Diagnostic code, e.g. BML_STYLE_PREFER_CDATA. (required)
+      </documentation>
     </code>
     <severity type="bomcommon:DiagnosticSeverity">
-      <documentation>warning or recommendation for v1 style rules. (required)</documentation>
+      <documentation>
+        warning or recommendation for v1 style rules. (required)
+      </documentation>
     </severity>
     <appliesTo type="type:Text">
-      <documentation>Human-readable target, e.g. block documentation. (required)</documentation>
+      <documentation>
+        Human-readable target, e.g. block documentation. (required)
+      </documentation>
     </appliesTo>
     <message type="type:Text">
-      <documentation>Diagnostic message emitted on match. (required)</documentation>
+      <documentation>
+        Diagnostic message emitted on match. (required)
+      </documentation>
     </message>
   </properties>
-
   <aggregations>
     <check>
-      <documentation>StyleCheck subtype that selects the TypeScript interpreter. (required)</documentation>
+      <documentation>
+        StyleCheck subtype that selects the TypeScript interpreter. (required)
+      </documentation>
       <composition>
         <valstyle:StyleCheck />
       </composition>
     </check>
   </aggregations>
-
-</block>
+</valstyle:StyleRule>