@blockml/bom 0.7.1 → 0.8.0

package/blocks/org/blockml/bml/bom/Library.bml

@@ -25,7 +25,7 @@
   xmlns:cap="org.blockml.bml.capability">
 
   <name>Library</name>
-  <type>blockml:Library</type>
+  <type>bom:Library</type>
   <baseType>core:BlockLibrary</baseType>
   <is>The BlockML BOM Urmodell library catalog</is>
 
@@ -36,14 +36,14 @@
     Membership is defined exclusively by this blocks list.
   </documentation>
 
-  <version>0.7.1</version>
+  <version>0.8.0</version>
 
   <language>
     <English />
   </language>
 
   <properties>
-    <description>
+    <description override="true">
       <value>BlockML BOM Urmodell library</value>
     </description>
   </properties>
@@ -60,7 +60,8 @@
       </composition>
     </dependencies>
     <blocks>
-      <composition><bom:UrmodellType />
+      <composition>
+        <bom:UrmodellType />
         <bomcommon:SourceLocation />
         <bomcommon:SourceInfo />
         <bomcommon:XmlTrivia />
@@ -73,6 +74,7 @@
         <bomcommon:XmlRenderingMember />
         <bomcommon:DiagnosticSeverity />
         <bomcommon:Diagnostic />
+        <bomcommon:HostValue />
         <bomvalue:Address />
         <bomvalue:MemberValue />
         <bomvalue:LiteralValue />

package/blocks/org/blockml/bml/bom/README.bml

@@ -24,7 +24,7 @@
   xmlns:type="org.blockml.bml.type">
 
   <name>README</name>
-  <type>blockml:README</type>
+  <type>bom:README</type>
   <baseType>core:ReadMe</baseType>
   <is>Reading entry for the BOM Urmodell library</is>
 

package/blocks/org/blockml/bml/bom/api/ParseOptions.bml

@@ -32,7 +32,7 @@
 
   <properties>
     <filePath type="type:Text">
-      <documentation>Default: "<memory>". (optional)</documentation>
+      <documentation>Default: "&lt;memory>". (optional)</documentation>
     </filePath>
     <continueOnError type="type:Boolean">
       <documentation>Default: true. (optional)</documentation>

package/blocks/org/blockml/bml/bom/block/BlockDefinition.bml

@@ -126,7 +126,7 @@
       <documentation>xmlTrivia (optional). TS type: bomcommon:XmlTrivia.</documentation>
     </xmlTrivia>
     <memberSectionTrivia type="type:Text">
-      <documentation>Partial<Record<MemberSectionName, XmlTrivia>>. (optional)</documentation>
+      <documentation>Partial&lt;Record&lt;MemberSectionName, XmlTrivia>>. (optional)</documentation>
     </memberSectionTrivia>
     <metadataTrivia type="bomcommon:MetadataElementTrivia">
       <documentation>metadataTrivia (optional). TS type: bomcommon:MetadataElementTrivia.</documentation>
@@ -135,13 +135,13 @@
       <documentation>source (optional). TS type: bomcommon:SourceLocation.</documentation>
     </source>
     <typeSource type="bomcommon:SourceLocation">
-      <documentation>Span of the type= attribute or <type> element value. (optional)</documentation>
+      <documentation>Span of the type= attribute or &lt;type> element value. (optional)</documentation>
     </typeSource>
     <baseTypeSource type="bomcommon:SourceLocation">
       <documentation>baseTypeSource (optional). TS type: bomcommon:SourceLocation.</documentation>
     </baseTypeSource>
     <unknownElements type="bomcommon:UnknownXmlNode[]">
-      <documentation>Preserve-on-error unknown root children. (optional)</documentation>
+      <documentation>unknownElements (optional). TS type: bomcommon:UnknownXmlNode[].</documentation>
     </unknownElements>
     <unknownAttributes type="type:Text">
       <documentation>Record of unknown attributes on the grammar node. (optional)</documentation>

package/blocks/org/blockml/bml/bom/capability/StripProvenance.bml

@@ -31,11 +31,11 @@
   <documentation>Removes sourceLocation, endLine, endColumn, SourceLocation-shaped fields (source, typeSource, baseTypeSource), and SourceInfo recursively. Preserves ImplementationBlock.source (implementation code body). Reference: packages/bom/src/equals.ts.</documentation>
 
   <properties>
-    <input type="core:Any">
-      <documentation>input (required). TS type: core:Any.</documentation>
+    <input type="bomcommon:HostValue">
+      <documentation>BML type gap: TS generic T. Deep-clone input. (required)</documentation>
     </input>
-    <output type="core:Any">
-      <documentation>output (required). TS type: core:Any.</documentation>
+    <output type="bomcommon:HostValue">
+      <documentation>BML type gap: TS generic T. Deep-clone without provenance. (required)</documentation>
     </output>
   </properties>
 

package/blocks/org/blockml/bml/bom/common/HostValue.bml

@@ -0,0 +1,33 @@
+<!--
+  BOM Urmodell — HostValue
+  FQN: org.blockml.bml.bom.common.HostValue
+-->
+<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
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>HostValue</name>
+  <type>bomcommon:HostValue</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Opaque host value for provenance-stripping</is>
+
+  <documentation>BML type gap: stands for TypeScript generic T / unknown. Deep-clone of any BOM-shaped graph; Core has no host-value type.</documentation>
+
+</block>

package/blocks/org/blockml/bml/bom/common/MetadataElementTrivia.bml

@@ -32,7 +32,7 @@
 
   <properties>
     <entries type="bomcommon:XmlTrivia">
-      <documentation>Record<string, XmlTrivia>. (optional)</documentation>
+      <documentation>Record&lt;string, XmlTrivia>. (optional)</documentation>
     </entries>
   </properties>
 

package/blocks/org/blockml/bml/bom/common/UnknownXmlNode.bml

@@ -28,21 +28,20 @@
   <baseType>bom:UrmodellType</baseType>
   <is>Preserve-on-error residual for an unknown authored XML element</is>
 
-  <documentation>Stored when a structural BML error is reported so Format/LSP/serialize
-    can roundtrip the authored construct instead of dropping it.</documentation>
+  <documentation>Stored when a structural BML error is reported so Format/LSP/serialize can roundtrip the authored construct.</documentation>
 
   <properties>
     <localName type="type:Text">
       <documentation>localName (required). TS type: type:Text.</documentation>
     </localName>
     <prefix type="type:Text">
-      <documentation>XML prefix when authored with a colon. (optional)</documentation>
+      <documentation>prefix (optional). TS type: type:Text.</documentation>
     </prefix>
     <attributes type="type:Text">
       <documentation>Record of authored attribute name → value. (required)</documentation>
     </attributes>
     <innerXml type="type:Text">
-      <documentation>Serialized inner XML of the element when it has children or text. (optional)</documentation>
+      <documentation>innerXml (optional). TS type: type:Text.</documentation>
     </innerXml>
     <source type="bomcommon:SourceLocation">
       <documentation>source (optional). TS type: bomcommon:SourceLocation.</documentation>

package/blocks/org/blockml/bml/bom/common/XmlTrivia.bml

@@ -28,7 +28,7 @@
   <baseType>bom:UrmodellType</baseType>
   <is>XML comment trivia bound to an element (B11)</is>
 
-  <documentation>Comment bodies only — without <!-- / -->. Bound to the following XML element.</documentation>
+  <documentation>Comment bodies only — without &lt;!-- / -->. Bound to the following XML element.</documentation>
 
   <properties>
     <leadingComments type="type:Text[]">

package/blocks/org/blockml/bml/bom/composition/BlockInstance.bml

@@ -56,7 +56,7 @@
       <documentation>namespace (optional). TS type: type:Text.</documentation>
     </namespace>
     <memberValues type="type:Text">
-      <documentation>Record<string, MemberValue>. (required)</documentation>
+      <documentation>Record&lt;string, MemberValue>. (required)</documentation>
     </memberValues>
     <aggregationCompositions type="bomcomp:InstanceAggregationComposition[]">
       <documentation>aggregationCompositions (optional). TS type: bomcomp:InstanceAggregationComposition[].</documentation>

package/blocks/org/blockml/bml/bom/documentation/PublicApi.bml

@@ -35,7 +35,7 @@
 
     ValidateResult: optional pragmaticModel (forked BomDocument), diagnostics[], success.
 
-    ParseOptions: filePath (default "<memory>"), continueOnError (default true).
+    ParseOptions: filePath (default "&lt;memory>"), continueOnError (default true).
 
     SerializeOptions: indent (default 2; 0=compact B13), xmlDeclaration (default false B17/B24).
 

package/blocks/org/blockml/bml/bom/documentation/ValidationResponsibilities.bml

@@ -40,12 +40,9 @@
     preset properties exist; property value cycles; basePresets resolve without cycles;
     contracts merge order; validateConstraints after resolveEffectiveMembers;
     readOnly enforcement (BML_READONLY_MEMBER_WRITE); library blocks/deps resolve;
-    no outer library re-export from inner library (BML_LIBRARY_NESTING_VIOLATION);
-    every type FQN in the registry (BML_UNKNOWN_TYPE); instance memberValues keys
-    exist on effective members (BML_UNKNOWN_PROPERTY error).
+    no outer library re-export from inner library (BML_LIBRARY_NESTING_VIOLATION).
 
-    Validator does NOT expand directives, assign auto-IDs, or interpret aggregations.
-    Structural unknown Gerüst tags are parser BML_UNKNOWN_ELEMENT, not this checklist.</documentation>
+    Validator does NOT expand directives, assign auto-IDs, or interpret aggregations.</documentation>
 
   <references>
     <see type="bomdocumentation:RelatedDiagnostics" relation="SeeAlso"></see>

package/blocks/org/blockml/bml/bom/member/MemberDefinitionBase.bml

@@ -89,7 +89,7 @@
       <documentation>Span of the type= attribute value (use-site for type diagnostics). (optional)</documentation>
     </typeSource>
     <unknownElements type="bomcommon:UnknownXmlNode[]">
-      <documentation>Preserve-on-error unknown children on this member. (optional)</documentation>
+      <documentation>unknownElements (optional). TS type: bomcommon:UnknownXmlNode[].</documentation>
     </unknownElements>
     <unknownAttributes type="type:Text">
       <documentation>Record of unknown attributes on this member. (optional)</documentation>

package/blocks/org/blockml/bml/bom/value/LiteralValue.bml

@@ -28,15 +28,15 @@
   <baseType>bomvalue:MemberValue</baseType>
   <is>Authored literal member value</is>
 
-  <documentation>value field is opaque (unknown) — MUST NOT be normalized at parse time (lossless roundtrip).</documentation>
+  <documentation>value field is a primitive union approximation of TS unknown — MUST NOT be normalized at parse time (lossless roundtrip). Objects/arrays remain a BML type gap.</documentation>
 
   <properties>
     <kind type="type:Text">
       <documentation>kind (required). TS type: type:Text.</documentation>
       <value>literal</value>
     </kind>
-    <value type="core:Any">
-      <documentation>Authored value exactly as in BML — opaque. (required)</documentation>
+    <value type="type:Text | type:Integer | type:Decimal | type:Boolean">
+      <documentation>BML type gap: TS unknown (authored literal, including objects/arrays). Union covers primitive cases only. (required)</documentation>
     </value>
     <typeFqn type="type:Text">
       <documentation>typeFqn (required). TS type: type:Text.</documentation>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockml/bom",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "BlockML BOM (Urmodell) TypeScript contracts — ParseResult, Diagnostic, bomEquals",
   "license": "Apache-2.0",
   "repository": {
@@ -32,7 +32,7 @@
     "test": "vitest run packages/bom/test"
   },
   "dependencies": {
-    "@blockml/core": "^1.0.5"
+    "@blockml/core": "^1.0.6"
   },
   "engines": {
     "node": ">=20"