@blockml/xsd-target 0.9.4 → 0.9.5

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — DomainVocabularyRules
-  FQN: org.blockml.bml.target.xsd.documentation.DomainVocabularyRules
--->
-<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 — DomainVocabularyRules
+  FQN: org.blockml.bml.target.xsd.documentation.DomainVocabularyRules-->
+<xsddocumentation:DomainVocabularyRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,21 +16,22 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>DomainVocabularyRules</name>
-  <type>xsddocumentation:DomainVocabularyRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>types.xsd and service.xsd vocabularies (XSD12–XSD13)</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    types.xsd and service.xsd vocabularies (XSD12–XSD13)
+  </is>
   <documentation>
     # types.xsd and service.xsd vocabularies (XSD12–XSD13)
-
+    
     XSD12: EmitTypesXsd — VocabularyElements under TYPE_FQN_PREFIX as xs:element type=xs:string
     in BML_TYPES_NS (http://blockml.org/schema/types).
-
+    
     XSD13: EmitServiceXsd — same for SERVICE_FQN_PREFIX under BML_SERVICE_NS.
-
+    
     Short name = last FQN segment after dot; sorted.
-
+    
     Gated by emitDomainSchemas (XSD15). Not MachineBlocks domain schemas.
   </documentation>
   <references>
@@ -44,5 +39,4 @@
     <see type="xsdcap:EmitTypesXsd" relation="SeeAlso" />
     <see type="xsdcap:EmitServiceXsd" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:DomainVocabularyRules>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — Introduction
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — Introduction
+  FQN: org.blockml.bml.target.xsd.documentation.Introduction-->
+<xsddocumentation:Introduction xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,30 +16,32 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Introduction</name>
-  <type>xsddocumentation:Introduction</type>
-  <baseType>core:Documentation</baseType>
-  <is>Purpose and scope of the XSD render target</is>
-
-  <documentation>The @blockml/xsd-target package implements RenderTarget registry name xsd.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Purpose and scope of the XSD render target
+  </is>
+  <documentation>
+    The @blockml/xsd-target package implements RenderTarget registry name xsd.
     It emits universal bml.xsd from D1 defaults plus meta Definition extras, optional
     types.xsd and service.xsd vocabularies, and a root catalog.xml.
-
+    
     This library (org.blockml.bml.target.xsd.*) is the SSOT. TypeScript in
     packages/xsd-target/src/ implements it. Tests in packages/xsd-target/test/
     encode behavioral contracts (XSD1–XSD18).
-
+    
     Generate vs Validation: this library models schema GENERATE only. Generated schemas
     are non-authoritative: they MUST NOT encode rules that parse + validate do not
     themselves enforce. Authoring validity is parse + @blockml/validator (CLI validate /
     LSP). compile xsd remains the generate path.
-
+    
     Pipeline: ResolveOptions → EmitBlockXsd [+ EmitTypesXsd / EmitServiceXsd] →
     EmitCatalogXml → files under outDir plus rootFiles catalog.xml.
-    Host CLI wiring (default outDir schemas/, write) lives in org.blockml.bml.cli.*</documentation>
+    Host CLI wiring (default outDir schemas/, write) lives in org.blockml.bml.cli.*
+  </documentation>
   <references>
     <see type="xsddocumentation:LayerSeparation" relation="ReadNext" />
     <see type="xsdcap:Render" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:Introduction>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — LayerSeparation
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — LayerSeparation
+  FQN: org.blockml.bml.target.xsd.documentation.LayerSeparation-->
+<xsddocumentation:LayerSeparation xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,21 +16,23 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>LayerSeparation</name>
-  <type>xsddocumentation: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.definition / docs 19 D1 — bml:xml particle grammar SSOT (XSD consumes)
     • org.blockml.bml.target.xsd.* (this library) — emit bml.xsd / types.xsd / service.xsd / catalog
     • org.blockml.bml.cli.* — default outDir=schemas, rootFiles write; validate is parse + validator
     • MachineBlocks domain XSDs — out of scope (product schemas)
-
-    Do not double-maintain CLI flags or D1 grammar here; link via SeeAlso.</documentation>
+    
+    Do not double-maintain CLI flags or D1 grammar here; link via SeeAlso.
+  </documentation>
   <references>
     <see type="xsddocumentation:ArchitectureOverview" relation="ReadNext" />
     <see type="cli:Library" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:LayerSeparation>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — PackageOwnership
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — PackageOwnership
+  FQN: org.blockml.bml.target.xsd.documentation.PackageOwnership-->
+<xsddocumentation:PackageOwnership xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,22 +16,24 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PackageOwnership</name>
-  <type>xsddocumentation:PackageOwnership</type>
-  <baseType>core:Documentation</baseType>
-  <is>What belongs in @blockml/xsd-target vs neighbors</is>
-
-  <documentation>Owns: registry name xsd, accepts, Options, emit of bml.xsd/types.xsd/service.xsd/catalog.xml,
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What belongs in @blockml/xsd-target vs neighbors
+  </is>
+  <documentation>
+    Owns: registry name xsd, accepts, Options, emit of bml.xsd/types.xsd/service.xsd/catalog.xml,
     D1 hardcoded lists + registry extras, MemberPrefersElement, NS/FQN constants.
-
+    
     Does not own: CLI default outDir=schemas, rootFiles write, exit codes (cli);
     D1/bml:xml grammar SSOT (Definition / docs 19);
     authoring validity (parser + validator; CLI validate);
     MachineBlocks domain XSDs.
-    Phase C IDE catalog narrative pointers in docs 15 stay host docs; generation here.</documentation>
+    Phase C IDE catalog narrative pointers in docs 15 stay host docs; generation here.
+  </documentation>
   <references>
     <see type="xsddocumentation:ScopeExclusions" relation="ReadNext" />
     <see type="cli:Library" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:PackageOwnership>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — ParticleMappingRules
-  FQN: org.blockml.bml.target.xsd.documentation.ParticleMappingRules
--->
-<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 — ParticleMappingRules
+  FQN: org.blockml.bml.target.xsd.documentation.ParticleMappingRules-->
+<xsddocumentation:ParticleMappingRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,13 +16,15 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ParticleMappingRules</name>
-  <type>xsddocumentation:ParticleMappingRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>bml.xsd particle construction (XSD4–XSD11)</is>
-
-  <documentation>Consumes D1 / bml:xml grammar from Definition (docs 19); does not redefine it.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    bml.xsd particle construction (XSD4–XSD11)
+  </is>
+  <documentation>
+    Consumes D1 / bml:xml grammar from Definition (docs 19); does not redefine it.
+    
     XSD4: targetNamespace http://blockml.org/bml; single root element block; mixed=true.
     XSD5: choice of unbounded optional xs:element particles only.
     XSD6: no element-level xs:any.
@@ -38,12 +34,12 @@
     XSD10: MemberPrefersElement — element/raw element true; sole attribute false;
     aggregations/associations true; default true.
     XSD11: extras exclude names already in D1 identity or containers.
-
-    Later: full D1 fidelity (attributes, text, nested models); pure Definition-driven lists.</documentation>
+    
+    Later: full D1 fidelity (attributes, text, nested models); pure Definition-driven lists.
+  </documentation>
   <references>
     <see type="xsddocumentation:DomainVocabularyRules" relation="ReadNext" />
     <see type="xsdcap:EmitBlockXsd" relation="SeeAlso" />
     <see type="def:BlockDefinition" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:ParticleMappingRules>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — PublicApi
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — PublicApi
+  FQN: org.blockml.bml.target.xsd.documentation.PublicApi-->
+<xsddocumentation:PublicApi 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>PublicApi</name>
-  <type>xsddocumentation:PublicApi</type>
-  <baseType>core:Documentation</baseType>
-  <is>Public TypeScript surface mirrored in this library</is>
-
-  <documentation>Exports (packages/xsd-target/src/index.ts):
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Public TypeScript surface mirrored in this library
+  </is>
+  <documentation>
+    Exports (packages/xsd-target/src/index.ts):
     XsdTarget, XsdRenderOutput; XsdOptions, resolveXsdOptions, DEFAULT_XSD_OPTIONS;
     emitBlockXsd, emitTypesXsd, emitServiceXsd; emitCatalogXml, catalogRelativePath, CatalogEntry;
     BML_DOCUMENT_NS, BML_TYPES_NS, BML_SERVICE_NS, TYPE_FQN_PREFIX, SERVICE_FQN_PREFIX.
-
+    
     Modeled as: api/XsdOptions, XsdRenderOutput, CatalogEntry; config/XsdConstants,
     DefaultXsdOptions; capabilities listed on Library.blocks.
-    Defines relation: this doc ↔ Options and Render.</documentation>
+    Defines relation: this doc ↔ Options and Render.
+  </documentation>
   <references>
     <see type="xsddocumentation:ParticleMappingRules" relation="ReadNext" />
     <see type="xsdapi:XsdOptions" relation="SeeAlso" />
     <see type="xsdcap:Render" relation="SeeAlso" />
     <see type="xsdconfig:DefaultXsdOptions" relation="SeeAlso" />
   </references>
-
-</block>
+</xsddocumentation:PublicApi>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — ScopeExclusions
-  FQN: org.blockml.bml.target.xsd.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
-                      "
+<!--XSD Documentation — ScopeExclusions
+  FQN: org.blockml.bml.target.xsd.documentation.ScopeExclusions-->
+<xsddocumentation:ScopeExclusions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,12 +16,14 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ScopeExclusions</name>
-  <type>xsddocumentation:ScopeExclusions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Explicitly out of XSD V1 library scope</is>
-
-  <documentation>Out of scope for this library / V1:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Explicitly out of XSD V1 library scope
+  </is>
+  <documentation>
+    Out of scope for this library / V1:
     • Authoring validation against generated XSD (parse + validator own validity)
     • Full D1 particle fidelity (attributes, text, nested content models)
     • Pure Definition-driven particle lists without hardcoded D1 arrays
@@ -36,6 +32,6 @@
     • Package-local emit diagnostics
     • CLI flag parsing and file I/O
     • Codegen from BML to TypeScript (structural SSOT only)
-    • BlockDoc / FatBlock / SCAD targets</documentation>
-
-</block>
+    • BlockDoc / FatBlock / SCAD targets
+  </documentation>
+</xsddocumentation:ScopeExclusions>

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

@@ -1,12 +1,6 @@
-<!--
-  XSD Documentation — V1Scope
-  FQN: org.blockml.bml.target.xsd.documentation.V1Scope
--->
-<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 — V1Scope
+  FQN: org.blockml.bml.target.xsd.documentation.V1Scope-->
+<xsddocumentation:V1Scope xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomblock="org.blockml.bml.bom.block"
@@ -22,12 +16,14 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>V1Scope</name>
-  <type>xsddocumentation:V1Scope</type>
-  <baseType>core:Documentation</baseType>
-  <is>What V1 delivers</is>
-
-  <documentation>V1 includes:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What V1 delivers
+  </is>
+  <documentation>
+    V1 includes:
     • Registry name xsd; accepts library, corpus, auto
     • Always bml.xsd: D1 identity + container lists + registry extras; no element xs:any;
       anyAttribute processContents=lax; mixed=true root block
@@ -36,11 +32,11 @@
     • Always OASIS catalog.xml via rootFiles
     • No package-local emit diagnostics
     • includeNonExported reserved unused
-
+    
     V1 does NOT include authoring XSD validation, MachineBlocks domain schemas,
-    or full attribute/text/nested particle models from Definition.</documentation>
+    or full attribute/text/nested particle models from Definition.
+  </documentation>
   <references>
     <see type="xsddocumentation:PublicApi" relation="ReadNext" />
   </references>
-
-</block>
+</xsddocumentation:V1Scope>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockml/xsd-target",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "BlockML XSD render target — XML Schema generation",
   "license": "Apache-2.0",
   "repository": {
@@ -32,10 +32,10 @@
     "test": "vitest run packages/xsd-target/test"
   },
   "dependencies": {
-    "@blockml/bom": "^0.9.4",
-    "@blockml/compiler": "^0.9.4",
-    "@blockml/core": "^1.1.2",
-    "@blockml/framework": "^0.9.4"
+    "@blockml/bom": "^0.9.5",
+    "@blockml/compiler": "^0.9.5",
+    "@blockml/core": "^1.2.1",
+    "@blockml/framework": "^0.9.5"
   },
   "engines": {
     "node": ">=20"