@blockml/bom 0.1.0

package/dist/equals.js

@@ -0,0 +1,94 @@
+function isSourceLocation(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj["file"] === "string" &&
+        typeof obj["line"] === "number" &&
+        typeof obj["column"] === "number");
+}
+function isSourceInfo(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const obj = value;
+    return obj["format"] === "xml" && typeof obj["filePath"] === "string";
+}
+/**
+ * Deep-clone a value tree omitting provenance keys recursively (B20).
+ * Removes SourceInfo, SourceLocation spans, and optional endLine/endColumn —
+ * but preserves ImplementationBlock.source (implementation code body).
+ */
+export function stripProvenance(node) {
+    if (node === null || node === undefined) {
+        return node;
+    }
+    if (Array.isArray(node)) {
+        return node.map((item) => stripProvenance(item));
+    }
+    if (typeof node !== "object") {
+        return node;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(node)) {
+        if (key === "sourceLocation" || key === "endLine" || key === "endColumn") {
+            continue;
+        }
+        if (key === "source" && (isSourceLocation(value) || isSourceInfo(value))) {
+            continue;
+        }
+        result[key] = stripProvenance(value);
+    }
+    return result;
+}
+function deepEqual(a, b) {
+    if (Object.is(a, b)) {
+        return true;
+    }
+    if (a === null || b === null || a === undefined || b === undefined) {
+        return a === b;
+    }
+    if (typeof a !== typeof b) {
+        return false;
+    }
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b) || a.length !== b.length) {
+            return false;
+        }
+        for (let i = 0; i < a.length; i++) {
+            if (!deepEqual(a[i], b[i])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    if (typeof a === "object") {
+        if (typeof b !== "object" || Array.isArray(b)) {
+            return false;
+        }
+        const aObj = a;
+        const bObj = b;
+        const aKeys = Object.keys(aObj).sort();
+        const bKeys = Object.keys(bObj).sort();
+        if (aKeys.length !== bKeys.length) {
+            return false;
+        }
+        for (let i = 0; i < aKeys.length; i++) {
+            const key = aKeys[i];
+            const bKey = bKeys[i];
+            if (key === undefined || bKey === undefined || key !== bKey) {
+                return false;
+            }
+            if (!deepEqual(aObj[key], bObj[bKey])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    return false;
+}
+/** Structural equality modulo provenance (B20). */
+export function bomEquals(a, b) {
+    return deepEqual(stripProvenance(a), stripProvenance(b));
+}
+//# sourceMappingURL=equals.js.map

package/dist/equals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equals.js","sourceRoot":"","sources":["../src/equals.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { SourceLocation, SourceInfo, XmlTrivia, MemberSectionName, MetadataElementTrivia, XmlNodeKind, CharacterDataForm, XmlRenderingBlock, XmlRenderingMember, DiagnosticSeverity, Diagnostic, } from "./types/common.js";
+export type { BomDocument } from "./types/document.js";
+export type { TypeReferenceEntityInstance, GenericType, BlockDefinition, KeywordEntry, DocumentationProseEntry, AliasEntry, ChangelogEntry, DocumentationExample, DocumentationReference, } from "./types/block-definition.js";
+export type { TypeExpression, TypeDescriptor, Multiplicity, InstanceConfiguration, NamedTypeReference, UnionTypeExpression, GenericParameterReference, SelfTypeReference, AnonymousStructType, StructField, } from "./types/type-expression.js";
+export type { MemberDefinition, ConstrainableDefinition, MemberDefinitionBase, PropertyDefinition, PropertyValueEntry, AggregationDefinition, AssociationDefinition, CapabilityDefinition, ImplementationBlock, EmbeddedExpression, } from "./types/member-definition.js";
+export type { CompositionTemplate, InstanceAggregationComposition, CompositionNode, BlockInstanceNode, VirtualContainerNode, BlockInstance, DirectiveAttribute, EachDirective, IfDirective, UnlessDirective, WithDirective, WithBinding, } from "./types/composition.js";
+export type { MemberValue, LiteralValue, ExpressionValue, AddressValue, Address, } from "./types/values.js";
+export type { ParseResult, SerializeResult, ParseOptions, SerializeOptions, ValidateResult, ValidateOptions, TypeRegistryReader, } from "./types/api.js";
+export { bomEquals, stripProvenance } from "./equals.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,YAAY,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,YAAY,EACV,2BAA2B,EAC3B,WAAW,EACX,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,OAAO,GACR,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { bomEquals, stripProvenance } from "./equals.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":"AAuFA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/api.d.ts

@@ -0,0 +1,50 @@
+import type { BomDocument } from "./document.js";
+import type { Diagnostic } from "./common.js";
+export interface ParseResult {
+    /** null only on hard fail (format / malformed XML / no usable root). */
+    document: BomDocument | null;
+    diagnostics: Diagnostic[];
+    /** false if any diagnostic has severity === "error". */
+    success: boolean;
+}
+export interface SerializeResult {
+    /** null only if serialize cannot produce text. */
+    text: string | null;
+    diagnostics: Diagnostic[];
+    success: boolean;
+}
+export interface ParseOptions {
+    /** default: "<memory>" — written to BomDocument.source.filePath */
+    filePath?: string;
+    /** default true — keep mapping after errors; attach document when possible */
+    continueOnError?: boolean;
+}
+export interface SerializeOptions {
+    /** default 2 — pretty-print spaces (B13); 0 = compact */
+    indent?: number;
+    /** default false — omit <?xml …?> (B17 / B24) */
+    xmlDeclaration?: boolean;
+}
+/** Minimal registry surface for ValidateOptions (implemented by @blockml/framework TypeRegistry). */
+export interface TypeRegistryReader {
+    get(fqn: string): BomDocument | undefined;
+    has(fqn: string): boolean;
+}
+export interface ValidateResult {
+    /** Forked pragmatic model when validation ran (resolve-only copy). */
+    pragmaticModel?: BomDocument;
+    diagnostics: Diagnostic[];
+    /** false if any diagnostic has severity === "error". */
+    success: boolean;
+}
+export interface ValidateOptions {
+    /** Pre-built registry; when omitted, bootstrap from bootstrapPaths / libraryPaths. */
+    typeRegistry?: TypeRegistryReader;
+    /** Directories scanned for .bml when typeRegistry omitted (corpus mode). */
+    bootstrapPaths?: string[];
+    /** Library.bml paths for library-graph bootstrap when typeRegistry omitted. */
+    libraryPaths?: string[];
+    /** default true — continue after errors; still attach pragmaticModel when possible */
+    continueOnError?: boolean;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/types/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":""}

package/dist/types/block-definition.d.ts

@@ -0,0 +1,150 @@
+import type { CharacterDataForm, MetadataElementTrivia, MemberSectionName, SourceLocation, XmlRenderingBlock, XmlTrivia } from "./common.js";
+import type { BlockInstance } from "./composition.js";
+import type { MemberDefinition } from "./member-definition.js";
+import type { CompositionTemplate } from "./composition.js";
+/** BOM shape for org.blockml.bml.type.TypeReferenceEntity(B[, D]) instances. */
+export interface TypeReferenceEntityInstance {
+    typeFqn: "org.blockml.bml.type.TypeReferenceEntity";
+    /** Authored / resolved TypeReference (FQN or TypeExpression). */
+    value: string;
+    /** Bound B from the aggregation type application (when recorded). */
+    boundB?: string;
+}
+export interface GenericType {
+    /** Parameter name (e.g. T). */
+    name: string;
+    /** FQN constraint — each concrete type argument must satisfy this bound. */
+    baseType: string;
+    /**
+     * Optional default when a generic application omits this argument.
+     * Concrete TypeExpression, or the name of an earlier sibling generic parameter.
+     */
+    defaultType?: string;
+}
+export interface BlockDefinition {
+    /** Short class name (PascalCase). Required. */
+    name: string;
+    /**
+     * Globally unique FQN.
+     * Required on root blocks (authored in BML).
+     * Derived on Sub-Blocks: parentFqn + "." + name
+     */
+    type: string;
+    /** Parent type FQN. Omitted in some corpus files. */
+    baseType?: string;
+    /** Semantic version of this definition. Omitted when inherited from Library. */
+    version?: string;
+    /** Required: names the Idea (Urbild). */
+    is?: string;
+    /** Short prose expansions (i18n + optional QName facets). */
+    summaries?: DocumentationProseEntry[];
+    /** Optional search/discovery tags — core.Keyword Entity instances. */
+    keywords?: KeywordEntry[];
+    /** Natural language for documentation prose — TypeReferenceEntity instance. */
+    language?: TypeReferenceEntityInstance;
+    /** Resolved FQN projection of language.value. */
+    languageFqn?: string;
+    /** Technical prose entries (i18n + optional QName facets). */
+    documentations?: DocumentationProseEntry[];
+    /** What this Block is not — required when confusion risk exists. */
+    isNot?: string;
+    /** Alternative names for this Block type — core.Alias Entity instances. */
+    aliases?: AliasEntry[];
+    /** Semantic version from which this definition is available. */
+    since?: string;
+    /** Version history entries — oldest first. */
+    changelog?: ChangelogEntry[];
+    /** Usage examples with character-data body. */
+    examples?: DocumentationExample[];
+    /** Cross-references to related Blocks or Definitions. */
+    references?: DocumentationReference[];
+    /** Abstract type — not usable as composition instance type. Default false. */
+    abstract?: boolean;
+    /** Final type — cannot be used as baseType on definitions. Default false. */
+    final?: boolean;
+    /** Authored block-level `<bml:xml>…</bml:xml>`. */
+    xmlRendering?: XmlRenderingBlock;
+    /** BlockML access visibility — Sub-Blocks only. */
+    visibility?: "private" | "protected" | "public";
+    /** Contract TypeReferenceEntity instances merged into this Block. Root block only. */
+    contracts?: TypeReferenceEntityInstance[];
+    /** Generic type parameters declared on this Block. */
+    genericTypes?: GenericType[];
+    /** Definition meta-model type FQN for this block's definition document. */
+    definitionFqn?: string;
+    /** Constraint Block instances on this Block definition. */
+    constraints?: BlockInstance[];
+    /**
+     * Members declared in THIS block only — not inherited.
+     * Array order is significant.
+     */
+    members: MemberDefinition[];
+    /** Sub-Block definitions nested under this block. */
+    subBlocks: BlockDefinition[];
+    /**
+     * Inline Library — virtual .bml files on the document root only.
+     * Each entry is EmbeddedBlockDefinition.
+     */
+    embeddedBlocks: BlockDefinition[];
+    /** Composition templates — derived from nested composition inside aggregation members. */
+    compositions: CompositionTemplate[];
+    /** XML comments on this definition element itself (B11). */
+    xmlTrivia?: XmlTrivia;
+    /** Comments bound to flattened member-section containers. */
+    memberSectionTrivia?: Partial<Record<MemberSectionName, XmlTrivia>>;
+    /** Comments bound to metadata child elements that map to fields. */
+    metadataTrivia?: MetadataElementTrivia;
+    /** BML source span of this definition (root or sub-block). */
+    source?: SourceLocation;
+}
+export interface KeywordEntry {
+    typeFqn: string;
+    term?: string;
+    languageFqn?: string;
+    weight?: number;
+    source?: SourceLocation;
+}
+export interface DocumentationProseEntry {
+    namespace: string;
+    text: string;
+    languageFqn: string;
+    authoredCharacterDataForm?: CharacterDataForm;
+    source?: SourceLocation;
+}
+export interface AliasEntry {
+    typeFqn: string;
+    name?: string;
+    languageFqn?: string;
+    legacy?: boolean;
+    source?: SourceLocation;
+}
+export interface ChangelogEntry {
+    version: string;
+    text: string;
+    languageFqn?: string;
+    source?: SourceLocation;
+}
+export interface DocumentationExample {
+    title: string;
+    content: string;
+    authoredCharacterDataForm?: CharacterDataForm;
+    contentLanguageFqn?: string;
+    snippet?: boolean;
+    namespace?: string;
+    source?: SourceLocation;
+}
+export interface DocumentationReference {
+    type?: string;
+    instance?: string;
+    file?: string;
+    url?: string;
+    property?: string;
+    aggregation?: string;
+    association?: string;
+    capability?: string;
+    relationFqn?: string;
+    context: string;
+    languageFqn?: string;
+    source?: SourceLocation;
+}
+//# sourceMappingURL=block-definition.d.ts.map

package/dist/types/block-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-definition.d.ts","sourceRoot":"","sources":["../../src/types/block-definition.ts"],"names":[],"mappings":"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"}

package/dist/types/block-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=block-definition.js.map

package/dist/types/block-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-definition.js","sourceRoot":"","sources":["../../src/types/block-definition.ts"],"names":[],"mappings":""}

package/dist/types/common.d.ts

@@ -0,0 +1,60 @@
+/** BML source span for diagnostics and LSP. */
+export interface SourceLocation {
+    file: string;
+    line: number;
+    column: number;
+    /** Optional end position for ranges. */
+    endLine?: number;
+    endColumn?: number;
+}
+/** Parse metadata for a BomDocument. */
+export interface SourceInfo {
+    /** Absolute or project-relative path. */
+    filePath: string;
+    /** "xml" only for authoring. */
+    format: "xml";
+    /**
+     * Authored xmlns prefix → namespace identifier (XML).
+     * Default xmlns uses prefix key "".
+     */
+    namespaceBindings?: Record<string, string>;
+    /** Authored xsi:schemaLocation value (opaque string). */
+    schemaLocation?: string;
+    /** Authored xsi:noNamespaceSchemaLocation when present. */
+    noNamespaceSchemaLocation?: string;
+}
+/**
+ * XML comment trivia bound to an element (B11).
+ * Bodies only — without `<!--` / `-->`.
+ */
+export interface XmlTrivia {
+    leadingComments?: string[];
+    trailingComments?: string[];
+}
+export type MemberSectionName = "properties" | "aggregations" | "associations" | "capabilities";
+/** Key = metadata child element localName. */
+export type MetadataElementTrivia = Record<string, XmlTrivia>;
+export type XmlNodeKind = "attribute" | "element" | "text";
+/** How host-element character data appeared in source when placement is `text` (D8). */
+export type CharacterDataForm = "text" | "cdata";
+/** Block-level `<bml:xml>` body — lossless. */
+export interface XmlRenderingBlock {
+    raw: string;
+}
+/** Member-level `bml:xml` — lossless + emit hints. */
+export interface XmlRenderingMember {
+    /** Authored `bml:xml` value (e.g. `element|attribute`). */
+    raw?: string;
+    kinds: XmlNodeKind[];
+    authoredPlacement?: XmlNodeKind;
+    authoredCharacterDataForm?: CharacterDataForm;
+}
+export type DiagnosticSeverity = "error" | "warning" | "info";
+/** Compiler result diagnostic — distinct from org.blockml.bml.core.Diagnostic BML branch. */
+export interface Diagnostic {
+    severity: DiagnosticSeverity;
+    code: string;
+    message: string;
+    source: SourceLocation;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,MAAM,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,cAAc,CAAC;AAEnB,8CAA8C;AAC9C,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,yBAAyB,CAAC,EAAE,iBAAiB,CAAC;CAC/C;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;CACxB"}

package/dist/types/common.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":""}

package/dist/types/composition.d.ts

@@ -0,0 +1,77 @@
+import type { MemberValue, ExpressionValue } from "./values.js";
+import type { SourceLocation, XmlTrivia } from "./common.js";
+/** Target aggregation name — e.g. "_parts", "blocks", "_presets". */
+export interface CompositionTemplate {
+    aggregationName: string;
+    directives?: DirectiveAttribute[];
+    children: CompositionNode[];
+    source?: SourceLocation;
+}
+/** Aggregation opened inline on a Block instance. */
+export interface InstanceAggregationComposition {
+    aggregationName: string;
+    composition: CompositionTemplate;
+}
+export type CompositionNode = BlockInstanceNode | VirtualContainerNode;
+export interface BlockInstanceNode {
+    kind: "blockInstance";
+    instance: BlockInstance;
+    /** bml:each, bml:if, bml:unless, bml:with on this block instance element. */
+    directives?: DirectiveAttribute[];
+    source?: SourceLocation;
+}
+export interface VirtualContainerNode {
+    kind: "virtualContainer";
+    /** bml:each, bml:if, bml:unless, bml:with on `<bml:container>`. */
+    directives?: DirectiveAttribute[];
+    children: CompositionNode[];
+    source?: SourceLocation;
+}
+/** Represents a concrete child block in a composition. */
+export interface BlockInstance {
+    /** Resolved FQN of the referenced block type. */
+    typeFqn: string;
+    /** Composition instance identity — from bml:id (literal or ExpressionValue). */
+    id?: MemberValue;
+    /** From bml:version — optional exact-version assert on external block references. */
+    version?: MemberValue;
+    /** From bml:bean — registers this instance as a named service bean. */
+    bean?: MemberValue;
+    /** From bml:scope — bean visibility: "local" (default) or "context". */
+    scope?: "local" | "context";
+    /** Preset reference: {PresetsDocumentFQN}::{preset-id}. */
+    basePresets?: string;
+    renderGroup?: string;
+    namespace?: string;
+    /** Member values set on this instance (properties + capabilities). */
+    memberValues: Record<string, MemberValue>;
+    /** Nested aggregation compositions on this instance. */
+    aggregationCompositions?: InstanceAggregationComposition[];
+    /** XML comments bound to this composition instance element (B11). */
+    xmlTrivia?: XmlTrivia;
+    source?: SourceLocation;
+}
+export type DirectiveAttribute = EachDirective | IfDirective | UnlessDirective | WithDirective;
+export interface EachDirective {
+    type: "each";
+    variables: string[];
+    statVariable?: string;
+    collection: ExpressionValue;
+}
+export interface IfDirective {
+    type: "if";
+    condition: ExpressionValue;
+}
+export interface UnlessDirective {
+    type: "unless";
+    condition: ExpressionValue;
+}
+export interface WithDirective {
+    type: "with";
+    bindings: WithBinding[];
+}
+export interface WithBinding {
+    name: string;
+    value: ExpressionValue;
+}
+//# sourceMappingURL=composition.d.ts.map

package/dist/types/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/types/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7D,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,mEAAmE;IACnE,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,uEAAuE;IACvE,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,wDAAwD;IACxD,uBAAuB,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC3D,qEAAqE;IACrE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,WAAW,GACX,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;CACxB"}

package/dist/types/composition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=composition.js.map

package/dist/types/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../src/types/composition.ts"],"names":[],"mappings":""}

package/dist/types/document.d.ts

@@ -0,0 +1,12 @@
+import type { SourceInfo } from "./common.js";
+import type { BlockDefinition } from "./block-definition.js";
+/** Every parsed or Builder-sealed BML document is exactly one BomDocument (Urmodell). */
+export interface BomDocument {
+    /** V1: always `<block>` root. */
+    kind: "block";
+    /** Parse metadata. */
+    source: SourceInfo;
+    /** Root block definition. */
+    block: BlockDefinition;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/types/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/types/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,eAAe,CAAC;CACxB"}

package/dist/types/document.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document.js.map

package/dist/types/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/types/document.ts"],"names":[],"mappings":""}

package/dist/types/member-definition.d.ts

@@ -0,0 +1,96 @@
+import type { CharacterDataForm, SourceLocation, XmlRenderingMember, XmlTrivia } from "./common.js";
+import type { BlockInstance } from "./composition.js";
+import type { ChangelogEntry, DocumentationExample, DocumentationProseEntry, DocumentationReference, KeywordEntry, TypeReferenceEntityInstance } from "./block-definition.js";
+import type { TypeDescriptor, TypeExpression } from "./type-expression.js";
+import type { MemberValue } from "./values.js";
+import type { CompositionTemplate } from "./composition.js";
+export type MemberDefinition = PropertyDefinition | AggregationDefinition | AssociationDefinition | CapabilityDefinition;
+export interface ConstrainableDefinition {
+    constraints?: BlockInstance[];
+}
+export interface MemberDefinitionBase {
+    /** Logical member name — visibility prefixes `_` / `__` stripped (B14). */
+    name: string;
+    summaries?: DocumentationProseEntry[];
+    keywords?: KeywordEntry[];
+    documentations?: DocumentationProseEntry[];
+    since?: string;
+    changelog?: ChangelogEntry[];
+    examples?: DocumentationExample[];
+    references?: DocumentationReference[];
+    /** Resolved canonical namespace identifier (FQN or URI). */
+    namespace?: string;
+    visibility?: "private" | "protected" | "public";
+    readOnly?: boolean;
+    abstract?: boolean;
+    final?: boolean;
+    override?: boolean;
+    xmlRendering?: XmlRenderingMember;
+    constraints?: BlockInstance[];
+    xmlTrivia?: XmlTrivia;
+    source?: SourceLocation;
+}
+export interface PropertyDefinition extends MemberDefinitionBase {
+    kind: "property";
+    /** Resolved type FQN for simple property types. */
+    typeFqn: string;
+    /** Full parse-time type expression when authored form is not a plain FQN (e.g. TypeReference(core:Block)). */
+    type?: TypeExpression;
+    values?: PropertyValueEntry[];
+    /** Convenience — default-namespace entry from values[]. */
+    value?: MemberValue;
+    group?: string;
+    /** Block instances of the same type as typeFqn — metadata only. */
+    suggestions?: BlockInstance[];
+    /** Member group TypeReferenceEntity instances (Property-only). */
+    groups?: TypeReferenceEntityInstance[];
+}
+export interface PropertyValueEntry {
+    /** "" = canonical value; else resolved Annotation FQN. */
+    namespace: string;
+    value: MemberValue;
+}
+export interface AggregationDefinition extends MemberDefinitionBase {
+    kind: "aggregation";
+    /** Full TypeExpression — plain Block[] or TypeReferenceEntity(T)[]. Omitted when not authored. */
+    type?: TypeExpression;
+    /** Omitted when not authored (inherited aggregation fill sites). */
+    cardinality?: "0..1" | "0..n" | "1..1" | "1..n";
+    default?: boolean;
+    /** Nested composition filling this aggregation — instance aggregations only. */
+    composition?: CompositionTemplate;
+    /** Member group TypeReferenceEntity instances. */
+    groups?: TypeReferenceEntityInstance[];
+    /** false when authored as direct block child (not inside `<aggregations>`). */
+    authoredInAggregationsSection?: boolean;
+}
+export interface AssociationDefinition extends MemberDefinitionBase {
+    kind: "association";
+    type: TypeExpression;
+    cardinality: "0..1" | "0..n";
+}
+export interface CapabilityDefinition extends MemberDefinitionBase {
+    kind: "capability";
+    typeFqn: string;
+    inputType?: TypeDescriptor;
+    outputType?: TypeDescriptor;
+    implementation?: ImplementationBlock;
+}
+export interface ImplementationBlock {
+    languageFqn: string;
+    /** Host-element character data — full original text including <$ $> regions. */
+    source: string;
+    authoredCharacterDataForm?: CharacterDataForm;
+    /** Embedded expression regions — defaults to [] when omitted. */
+    embeddedExpressions?: EmbeddedExpression[];
+    sourceLocation?: SourceLocation;
+}
+export interface EmbeddedExpression {
+    /** Expression text between delimiters (for later parseExpression). */
+    raw: string;
+    /** Byte/char offset of opening <$ in source. */
+    start: number;
+    /** Offset immediately after closing $>. */
+    end: number;
+}
+//# sourceMappingURL=member-definition.d.ts.map