@blockml/parser 0.1.0

package/blocks/org/blockml/bml/compiler/parser/documentation/MemberMappingOrder.bml

@@ -0,0 +1,46 @@
+<!--
+  Parser Documentation — MemberMappingOrder
+  FQN: org.blockml.bml.compiler.parser.documentation.MemberMappingOrder
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>MemberMappingOrder</name>
+  <type>pardocumentation:MemberMappingOrder</type>
+  <baseType>core:Documentation</baseType>
+  <is>BML document order preserved in members[]</is>
+
+  <documentation>Append to members[] in BML document order — the order elements appear in source.
+
+    • Element localName = member name (no name= attribute on member elements)
+    • MUST NOT sort by name, kind, or type
+    • Ordinal = index in members[] — roundtrip must preserve array order
+    • Parser accepts any authored sibling order; serializer emits canonical order (B12)
+
+    Inside containers (properties/aggregations/…): filter by kind, keep BOM array order.</documentation>
+
+  <references>
+    <see type="pardocumentation:AttributeClassification" relation="ReadNext"></see>
+  </references>
+
+</block>

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

@@ -0,0 +1,50 @@
+<!--
+  Parser Documentation — PackageOwnership
+  FQN: org.blockml.bml.compiler.parser.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
+                      "
+  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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>PackageOwnership</name>
+  <type>pardocumentation:PackageOwnership</type>
+  <baseType>core:Documentation</baseType>
+  <is>Toolchain package responsibilities for parsing</is>
+
+  <documentation>@blockml/parser — BML XML → BomDocument; parse() → ParseResult.
+    Owns mapping algorithm, Stage 1 pipeline [1]–[5], this BML library.
+
+    @blockml/bom — Urmodell types, ParseOptions/ParseResult (B26), Diagnostic,
+    bomEquals/stripProvenance (B20). Parser produces; does not redefine.
+
+    @blockml/framework — TypeRegistry, parseExpression(), Definition meta-model, validateTypes.
+    Parser consumes implicit namespace rules; defers AST and semantic validation.
+
+    @blockml/serializer — BOM → BML inverse. @blockml/validator — Stage 2 checks.
+    @blockml/cli — TypeRegistry bootstrap and orchestration.</documentation>
+
+  <references>
+    <see type="pardocumentation:ScopeExclusions" relation="ReadNext"></see>
+    <see type="bomdocumentation:PackageOwnership" relation="SeeAlso"></see>
+  </references>
+
+</block>

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

@@ -0,0 +1,58 @@
+<!--
+  Parser Documentation — PublicApi
+  FQN: org.blockml.bml.compiler.parser.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
+                      "
+  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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>PublicApi</name>
+  <type>pardocumentation:PublicApi</type>
+  <baseType>core:Documentation</baseType>
+  <is>parse() entry point (B26)</is>
+
+  <documentation>parse(source: string, options?: ParseOptions): ParseResult
+
+    ParseOptions (owned by @blockml/bom):
+    • filePath — default "<memory>"; written to BomDocument.source.filePath
+    • continueOnError — default true; keep mapping after errors when possible
+
+    ParseResult (owned by @blockml/bom):
+    • document — BomDocument | null (null on hard fail)
+    • diagnostics — Diagnostic[]
+    • success — false if any diagnostic has severity === "error"
+
+    Behaviour:
+    • B24 detect → [2] xmldom → [3]–[5] map
+    • Hard fail → document: null (unsupported format, missing root, invalid root)
+    • Mapping errors → BML_MAP_ERROR; with continueOnError still return document when possible
+    • Sync only; no throw on recoverable errors
+    • Does NOT call validator; does NOT expand directives</documentation>
+
+  <references>
+    <see type="bomapi:ParseOptions" relation="Defines"></see>
+    <see type="bomapi:ParseResult" relation="Defines"></see>
+    <see type="parcap:Parse" relation="Defines"></see>
+    <see type="pardocumentation:MappingPrinciples" relation="ReadNext"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/documentation/RoundtripContract.bml

@@ -0,0 +1,50 @@
+<!--
+  Parser Documentation — RoundtripContract
+  FQN: org.blockml.bml.compiler.parser.documentation.RoundtripContract
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>RoundtripContract</name>
+  <type>pardocumentation:RoundtripContract</type>
+  <baseType>core:Documentation</baseType>
+  <is>Parse-side roundtrip obligations (B10/B11/B13/B20)</is>
+
+  <documentation>Phase-A gate: bomEquals(stripProvenance(parse(serialize(parse(f)))), parse(f)).
+    Shared definition in @blockml/bom (B20).
+
+    Parser obligations:
+    • Preserve semantic content for serializer re-emit
+    • Store xmlRendering, authoredPlacement, authoredCharacterDataForm, namespaceBindings
+    • Do NOT require storing formatting whitespace (B13)
+    • Single-file roundtrip tests do not require TypeRegistry bootstrap
+
+    XML byte fidelity NOT a gate — see @blockml/serializer RoundtripContract.</documentation>
+
+  <references>
+    <see type="bomcap:BomEquals" relation="SeeAlso"></see>
+    <see type="serdocumentation:RoundtripContract" relation="SeeAlso"></see>
+    <see type="pardocumentation:Diagnostics" relation="ReadNext"></see>
+  </references>
+
+</block>

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

@@ -0,0 +1,49 @@
+<!--
+  Parser Documentation — ScopeExclusions
+  FQN: org.blockml.bml.compiler.parser.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
+                      "
+  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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>ScopeExclusions</name>
+  <type>pardocumentation:ScopeExclusions</type>
+  <baseType>core:Documentation</baseType>
+  <is>Explicit out-of-scope for the parser package</is>
+
+  <documentation>Out of scope for @blockml/parser:
+
+    • BOM → BML emit — @blockml/serializer
+    • Semantic validation — @blockml/validator
+    • TypeRegistry bootstrap / cross-file resolve — @blockml/cli + @blockml/framework
+    • parseExpression() AST — @blockml/framework (Stage 2)
+    • Render target output — @blockml/compiler
+    • parseFile, async, streaming — deferred API
+    • Meta-driven mapping from Definition blocks — V2
+
+    In scope: single-file BML XML → lossless BomDocument.</documentation>
+
+  <references>
+    <see type="pardocumentation:Introduction" relation="SeeAlso"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/documentation/SingleFileScope.bml

@@ -0,0 +1,47 @@
+<!--
+  Parser Documentation — SingleFileScope
+  FQN: org.blockml.bml.compiler.parser.documentation.SingleFileScope
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>SingleFileScope</name>
+  <type>pardocumentation:SingleFileScope</type>
+  <baseType>core:Documentation</baseType>
+  <is>One BomDocument per parse(); external refs as strings (B5)</is>
+
+  <documentation>parse() produces exactly one BomDocument per invocation.
+
+    Cross-file references stored in authored form:
+    • type/baseType FQNs as resolved strings
+    • Preset refs as FQN::id strings (unmerged)
+    • bml:version on instances — no registry lookup at parse time
+
+    TypeRegistry bootstrap, effective member resolution, cross-file validation →
+    @blockml/cli orchestrator + @blockml/core utilities + @blockml/validator.</documentation>
+
+  <references>
+    <see type="pardocumentation:DesignDecisions" relation="ReadNext"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/documentation/TypeDescriptorParsing.bml

@@ -0,0 +1,47 @@
+<!--
+  Parser Documentation — TypeDescriptorParsing
+  FQN: org.blockml.bml.compiler.parser.documentation.TypeDescriptorParsing
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>TypeDescriptorParsing</name>
+  <type>pardocumentation:TypeDescriptorParsing</type>
+  <baseType>core:Documentation</baseType>
+  <is>TypeExpression parsing at map time</is>
+
+  <documentation>Parse type attribute strings into BOM TypeExpression shapes (defined in @blockml/bom).
+
+    • Named type refs → resolved FQN via namespace bindings + implicit namespaces
+    • Union (A | B), struct ({ a: T }), multiplicity, generics, self refs
+    • Boolean.True/Boolean.False preserved as type refs (B16) — not rewritten to literals
+    • Boolean values normalized to lowercase (B15)
+    • Failure → BML_UNKNOWN_TYPE
+    • Anonymous struct at specialized sites; context-bound implicit namespaces per 02_mbml.md</documentation>
+
+  <references>
+    <see type="parcap:ParseTypeExpression" relation="Defines"></see>
+    <see type="pardocumentation:BlockMetadataMapping" relation="ReadNext"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/documentation/V1Scope.bml

@@ -0,0 +1,48 @@
+<!--
+  Parser Documentation — V1Scope
+  FQN: org.blockml.bml.compiler.parser.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
+                      "
+  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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>V1Scope</name>
+  <type>pardocumentation:V1Scope</type>
+  <baseType>core:Documentation</baseType>
+  <is>Phase A parser slice and deferred features</is>
+
+  <documentation>V1 (Phase A) parser implements:
+    • Hardcoded BML → BOM mapper for <block> root documents
+    • Single-file scope (B5) — no TypeRegistry bootstrap in parse()
+    • Stage 1 only — no semantic validation (B8: XSD not Stage 1)
+    • JSON BML authoring not planned (B6)
+    • Tolerant parse by default (continueOnError: true)
+
+    Deferred: cross-file resolution, parseFile/async, streaming, parse({ validate: true }),
+    meta-driven mapping from Definition blocks (V2).</documentation>
+
+  <references>
+    <see type="pardocumentation:PublicApi" relation="ReadNext"></see>
+    <see type="pardocumentation:SingleFileScope" relation="SeeAlso"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/documentation/XmlCommentsParse.bml

@@ -0,0 +1,48 @@
+<!--
+  Parser Documentation — XmlCommentsParse
+  FQN: org.blockml.bml.compiler.parser.documentation.XmlCommentsParse
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:doc="org.blockml.bml.documentation">
+
+  <name>XmlCommentsParse</name>
+  <type>pardocumentation:XmlCommentsParse</type>
+  <baseType>core:Documentation</baseType>
+  <is>Comment binding algorithm (B11 parse side)</is>
+
+  <documentation>Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
+
+    Parse algorithm:
+    • pendingLeading comments → bind to next element as leadingComments
+    • Comments after element end tag → trailingComments on that element
+    • Storage: xmlTrivia on elements, memberSectionTrivia, metadataTrivia
+
+    Comment bodies only — without <!-- / -->. Whitespace/layout not stored (B13).
+    Re-emit rules (B22) → @blockml/serializer.</documentation>
+
+  <references>
+    <see type="bomdocumentation:XmlComments" relation="SeeAlso"></see>
+    <see type="pardocumentation:TypeDescriptorParsing" relation="ReadNext"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/map/MapContext.bml

@@ -0,0 +1,58 @@
+<!--
+  Parser — MapContext
+  FQN: org.blockml.bml.compiler.parser.map.MapContext
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>MapContext</name>
+  <type>parmap:MapContext</type>
+  <baseType>parser:ParserType</baseType>
+  <is>Per-parse mapping configuration and namespace context</is>
+
+  <documentation>Created by createMapContext(). Passed through map/* modules during step [5].</documentation>
+
+  <properties>
+    <filePath type="type:Text">
+      <documentation>filePath. TS type: type:Text. (required)</documentation>
+    </filePath>
+    <source type="type:Text">
+      <documentation>Original source string. (required)</documentation>
+    </source>
+    <bindings type="type:Text">
+      <documentation>Record<string, string> namespace bindings. (required)</documentation>
+    </bindings>
+    <subBlockIndex type="type:Text">
+      <documentation>Map<string, string> sub-block lookup. (required)</documentation>
+    </subBlockIndex>
+    <parentBlockType type="type:Text">
+      <documentation>Enclosing block type FQN when nested. (optional)</documentation>
+    </parentBlockType>
+    <isRoot type="type:Boolean">
+      <documentation>isRoot. TS type: type:Boolean. (required)</documentation>
+    </isRoot>
+    <isEmbedded type="type:Boolean">
+      <documentation>isEmbedded. TS type: type:Boolean. (required)</documentation>
+    </isEmbedded>
+  </properties>
+
+</block>

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { parse } from "./parse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { parse } from "./parse.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/map/context.d.ts

@@ -0,0 +1,16 @@
+export interface MapContext {
+    filePath: string;
+    source: string;
+    bindings: Record<string, string>;
+    subBlockIndex: Map<string, string>;
+    parentBlockType?: string;
+    isRoot: boolean;
+    isEmbedded: boolean;
+}
+export declare function createMapContext(filePath: string, source: string, bindings: Record<string, string>, options?: {
+    subBlockIndex?: Map<string, string>;
+    parentBlockType?: string;
+    isRoot?: boolean;
+    isEmbedded?: boolean;
+}): MapContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/map/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/map/context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,UAAU,CAaZ"}

package/dist/map/context.js

@@ -0,0 +1,15 @@
+export function createMapContext(filePath, source, bindings, options = {}) {
+    const ctx = {
+        filePath,
+        source,
+        bindings,
+        subBlockIndex: options.subBlockIndex ?? new Map(),
+        isRoot: options.isRoot ?? false,
+        isEmbedded: options.isEmbedded ?? false,
+    };
+    if (options.parentBlockType !== undefined) {
+        ctx.parentBlockType = options.parentBlockType;
+    }
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/map/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/map/context.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,MAAc,EACd,QAAgC,EAChC,UAKI,EAAE;IAEN,MAAM,GAAG,GAAe;QACtB,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,GAAG,EAAE;QACjD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;KACxC,CAAC;IACF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC1C,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/map/directives.d.ts

@@ -0,0 +1,23 @@
+import type { DirectiveAttribute, ExpressionValue } from "@blockml/bom";
+import type { Element } from "@xmldom/xmldom";
+import type { SourceLocation } from "@blockml/bom";
+export declare function parseDirectives(element: Element, loc: SourceLocation): DirectiveAttribute[];
+export declare function parseBmlMeta(element: Element, typeFqn: string, file: string, loc: SourceLocation): {
+    id: ExpressionValue | {
+        kind: "literal";
+        value: string;
+        typeFqn: string;
+    } | undefined;
+    version: ExpressionValue | {
+        kind: "literal";
+        value: string;
+        typeFqn: string;
+    } | undefined;
+    bean: ExpressionValue | {
+        kind: "literal";
+        value: string;
+        typeFqn: string;
+    } | undefined;
+    scope: "local" | "context" | undefined;
+};
+//# sourceMappingURL=directives.d.ts.map

package/dist/map/directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../../src/map/directives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,eAAe,EAKhB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAWnD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,cAAc,GAClB,kBAAkB,EAAE,CA4DtB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc;;;;;;;;;;;;;;;;;EAiBpB"}