@abapify/ts-xsd 0.3.6 → 0.4.1

package/dist/index.mjs

@@ -0,0 +1,1116 @@
+import { _ as getAllChildElements, a as loadAndLinkSchema, b as getLocalName, c as getSubstitutes, d as SchemaTraverser, f as resolveSchemaTypes, g as parseXsd, h as buildXsd, i as linkSchema, l as resolveSchema, m as resolveImports, n as createSchemaLoader, o as loadSchema, p as linkSchemas, r as defaultLoader, s as parseSchemaContent, t as runCodegen, u as SchemaResolver, v as getAttributeValue, x as getTextContent, y as getChildElements } from "./runner-CRhT3smd.mjs";
+import { n as generateSchemaLiteral, t as generateSchemaFile } from "./generate-DnX2dJZe.mjs";
+import { n as deriveRootTypeName, r as generateInterfaces, t as defineConfig } from "./types-CtrpGRyM.mjs";
+import { DOMImplementation, DOMParser, XMLSerializer } from "@xmldom/xmldom";
+
+//#region src/walker/index.ts
+/**
+* Walk all complexTypes in a schema and its $imports/$includes (depth-first).
+*
+* @param schema - Root schema to start from
+* @param options - Walk options (e.g., includesOnly to skip $imports)
+* @yields ComplexType with the schema it was found in
+*
+* @example
+* ```typescript
+* function findComplexType(name: string, schema: SchemaLike) {
+*   for (const { ct, schema: s } of walkComplexTypes(schema)) {
+*     if (ct.name === name) return { type: ct, schema: s };
+*   }
+* }
+* ```
+*/
+function* walkComplexTypes(schema, options = {}) {
+	const complexTypes = schema.complexType;
+	if (complexTypes) if (Array.isArray(complexTypes)) for (const ct of complexTypes) yield {
+		ct,
+		schema
+	};
+	else for (const [name, ct] of Object.entries(complexTypes)) yield {
+		ct: {
+			...ct,
+			name
+		},
+		schema
+	};
+	if (schema.redefine) {
+		for (const redef of schema.redefine) if (redef.complexType) for (const ct of redef.complexType) yield {
+			ct,
+			schema
+		};
+	}
+	if (schema.override) {
+		for (const ovr of schema.override) if (ovr.complexType) for (const ct of ovr.complexType) yield {
+			ct,
+			schema
+		};
+	}
+	if (schema.$includes) for (const included of schema.$includes) yield* walkComplexTypes(included, options);
+	if (!options.includesOnly && schema.$imports) for (const imported of schema.$imports) yield* walkComplexTypes(imported, options);
+}
+/**
+* Walk all simpleTypes in a schema and its $imports/$includes.
+*/
+function* walkSimpleTypes(schema, options = {}) {
+	const simpleTypes = schema.simpleType;
+	if (simpleTypes) if (Array.isArray(simpleTypes)) for (const st of simpleTypes) yield {
+		st,
+		schema
+	};
+	else for (const [name, st] of Object.entries(simpleTypes)) yield {
+		st: {
+			...st,
+			name
+		},
+		schema
+	};
+	if (schema.redefine) {
+		for (const redef of schema.redefine) if (redef.simpleType) for (const st of redef.simpleType) yield {
+			st,
+			schema
+		};
+	}
+	if (schema.override) {
+		for (const ovr of schema.override) if (ovr.simpleType) for (const st of ovr.simpleType) yield {
+			st,
+			schema
+		};
+	}
+	if (schema.$includes) for (const included of schema.$includes) yield* walkSimpleTypes(included, options);
+	if (!options.includesOnly && schema.$imports) for (const imported of schema.$imports) yield* walkSimpleTypes(imported, options);
+}
+/**
+* Walk all top-level elements in a schema and its $imports/$includes.
+*/
+function* walkTopLevelElements(schema, options = {}) {
+	if (schema.element) for (const element of schema.element) yield {
+		element,
+		schema
+	};
+	if (schema.$includes) for (const included of schema.$includes) yield* walkTopLevelElements(included, options);
+	if (!options.includesOnly && schema.$imports) for (const imported of schema.$imports) yield* walkTopLevelElements(imported, options);
+}
+/**
+* Find a complexType by name, searching schema and $imports.
+* Returns both the type AND the schema it was found in (important for inheritance).
+*/
+function findComplexType(name, schema) {
+	for (const entry of walkComplexTypes(schema)) if (entry.ct.name === name) return entry;
+}
+/**
+* Find a simpleType by name, searching schema and $imports.
+*/
+function findSimpleType(name, schema) {
+	for (const entry of walkSimpleTypes(schema)) if (entry.st.name === name) return entry;
+}
+/**
+* Find a top-level element by name, searching schema and $imports.
+*/
+function findElement(name, schema) {
+	for (const entry of walkTopLevelElements(schema)) if (entry.element.name === name) return entry;
+}
+/**
+* Walk all elements in a complexType, handling:
+* - sequence, choice, all groups
+* - Nested groups (recursive)
+* - complexContent/extension inheritance
+* - Group references
+*
+* @param ct - ComplexType to walk
+* @param schema - Schema context (for resolving base types and group refs)
+* @yields Elements with metadata (optional, array, source)
+*/
+function* walkElements(ct, schema) {
+	if (ct.complexContent?.extension) {
+		const ext = ct.complexContent.extension;
+		if (ext.base) {
+			const baseEntry = findComplexType(stripNsPrefix(ext.base), schema);
+			if (baseEntry) yield* walkElements(baseEntry.ct, baseEntry.schema);
+		}
+		yield* walkGroup(ext.sequence, "sequence", schema);
+		yield* walkGroup(ext.choice, "choice", schema);
+		yield* walkGroup(ext.all, "all", schema);
+		if (ext.group?.ref) yield* walkGroupRef(ext.group.ref, schema);
+		return;
+	}
+	if (ct.complexContent?.restriction) {
+		const rest = ct.complexContent.restriction;
+		yield* walkGroup(rest.sequence, "sequence", schema);
+		yield* walkGroup(rest.choice, "choice", schema);
+		yield* walkGroup(rest.all, "all", schema);
+		if (rest.group?.ref) yield* walkGroupRef(rest.group.ref, schema);
+		return;
+	}
+	yield* walkGroup(ct.sequence, "sequence", schema);
+	yield* walkGroup(ct.choice, "choice", schema);
+	yield* walkGroup(ct.all, "all", schema);
+	if (ct.group?.ref) yield* walkGroupRef(ct.group.ref, schema);
+}
+/**
+* Walk elements in a group (sequence/choice/all), handling nested groups.
+*/
+function* walkGroup(group, source, schema, parentOptional = false, parentArray = false) {
+	if (!group) return;
+	const groupOptional = parentOptional || group.minOccurs === 0 || group.minOccurs === "0";
+	const groupArray = parentArray || isArray(group);
+	const choiceOptional = source === "choice";
+	if (group.element) for (const element of group.element) {
+		const optional = choiceOptional || groupOptional || element.minOccurs === 0 || element.minOccurs === "0";
+		const array = groupArray || isArray(element);
+		if (element.ref) {
+			const refName = stripNsPrefix(element.ref);
+			const refEntry = findElement(refName, schema);
+			if (refEntry && isAbstractElement(refEntry.element)) {
+				const substitutes = findSubstitutes(refName, schema);
+				if (substitutes.length > 0) {
+					for (const sub of substitutes) yield {
+						element: sub,
+						optional,
+						array,
+						source,
+						schema
+					};
+					continue;
+				}
+			}
+		}
+		yield {
+			element,
+			optional,
+			array,
+			source,
+			schema
+		};
+	}
+	if (group.sequence) {
+		const sequences = Array.isArray(group.sequence) ? group.sequence : [group.sequence];
+		for (const nested of sequences) yield* walkGroup(nested, "sequence", schema, groupOptional, groupArray);
+	}
+	if (group.choice) {
+		const choices = Array.isArray(group.choice) ? group.choice : [group.choice];
+		for (const nested of choices) yield* walkGroup(nested, "choice", schema, true, groupArray || isArray(nested));
+	}
+	if (group.group) {
+		const refs = Array.isArray(group.group) ? group.group : [group.group];
+		for (const ref of refs) if (ref.ref) yield* walkGroupRef(ref.ref, schema, groupOptional || choiceOptional, groupArray || isArray(ref));
+	}
+}
+/**
+* Walk elements from a group reference (xs:group ref="...").
+*/
+function* walkGroupRef(ref, schema, parentOptional = false, parentArray = false) {
+	const group = findGroup(stripNsPrefix(ref), schema);
+	if (group) {
+		if (group.sequence) yield* walkGroup(group.sequence, "sequence", schema, parentOptional, parentArray);
+		if (group.choice) yield* walkGroup(group.choice, "choice", schema, true, parentArray);
+		if (group.all) yield* walkGroup(group.all, "all", schema, parentOptional, parentArray);
+	}
+}
+/**
+* Walk all attributes in a complexType, handling:
+* - Direct attributes
+* - complexContent/extension attributes
+* - simpleContent/extension attributes
+* - Inherited attributes from base type
+* - AttributeGroup references
+*/
+function* walkAttributes(ct, schema) {
+	if (ct.complexContent?.extension) {
+		const ext = ct.complexContent.extension;
+		if (ext.base) {
+			const baseEntry = findComplexType(stripNsPrefix(ext.base), schema);
+			if (baseEntry) yield* walkAttributes(baseEntry.ct, baseEntry.schema);
+		}
+		if (ext.attribute) for (const attr of ext.attribute) {
+			const resolved = resolveAttribute(attr, schema);
+			if (resolved) yield {
+				attribute: resolved,
+				required: resolved.use === "required",
+				schema
+			};
+		}
+		yield* walkAttributeGroupRefs(ext.attributeGroup, schema);
+		return;
+	}
+	if (ct.simpleContent?.extension) {
+		const ext = ct.simpleContent.extension;
+		if (ext.attribute) for (const attr of ext.attribute) {
+			const resolved = resolveAttribute(attr, schema);
+			if (resolved) yield {
+				attribute: resolved,
+				required: resolved.use === "required",
+				schema
+			};
+		}
+		yield* walkAttributeGroupRefs(ext.attributeGroup, schema);
+		return;
+	}
+	if (ct.attribute) for (const attr of ct.attribute) {
+		const resolved = resolveAttribute(attr, schema);
+		if (resolved) yield {
+			attribute: resolved,
+			required: resolved.use === "required",
+			schema
+		};
+	}
+	yield* walkAttributeGroupRefs(ct.attributeGroup, schema);
+}
+/**
+* Walk attributes from attributeGroup references.
+*/
+function* walkAttributeGroupRefs(refs, schema) {
+	if (!refs) return;
+	for (const ref of refs) {
+		const refObj = ref;
+		if (refObj.ref) {
+			const group = findAttributeGroup(stripNsPrefix(refObj.ref), schema);
+			if (group?.attribute) for (const attribute of group.attribute) yield {
+				attribute,
+				required: attribute.use === "required",
+				schema
+			};
+		}
+	}
+}
+/**
+* Find a named group (xs:group) by name.
+*/
+function findGroup(name, schema) {
+	if (schema.group) {
+		for (const g of schema.group) if (g.name === name) return g;
+	}
+	if (schema.$includes) for (const included of schema.$includes) {
+		const found = findGroup(name, included);
+		if (found) return found;
+	}
+	if (schema.$imports) for (const imported of schema.$imports) {
+		const found = findGroup(name, imported);
+		if (found) return found;
+	}
+}
+/**
+* Find a top-level attribute by name.
+* Searches current schema and $imports.
+*/
+function findAttribute(name, schema) {
+	const schemaWithAttrs = schema;
+	if (schemaWithAttrs.attribute) {
+		for (const attr of schemaWithAttrs.attribute) if (attr.name === name) return attr;
+	}
+	if (schema.$includes) for (const included of schema.$includes) {
+		const found = findAttribute(name, included);
+		if (found) return found;
+	}
+	if (schema.$imports) for (const imported of schema.$imports) {
+		const found = findAttribute(name, imported);
+		if (found) return found;
+	}
+}
+/**
+* Resolve an attribute - handles both direct attributes and refs.
+* Returns the resolved attribute with its name.
+*/
+function resolveAttribute(attribute, schema) {
+	if (attribute.ref) {
+		const refName = stripNsPrefix(attribute.ref);
+		const resolved = findAttribute(refName, schema);
+		if (resolved) return {
+			...resolved,
+			use: attribute.use ?? resolved.use
+		};
+		return {
+			name: refName,
+			type: "xs:string",
+			use: attribute.use
+		};
+	}
+	return attribute;
+}
+/**
+* Find an attributeGroup by name.
+*/
+function findAttributeGroup(name, schema) {
+	if (schema.attributeGroup) {
+		for (const g of schema.attributeGroup) if (g.name === name) return g;
+	}
+	if (schema.$includes) for (const included of schema.$includes) {
+		const found = findAttributeGroup(name, included);
+		if (found) return found;
+	}
+	if (schema.$imports) for (const imported of schema.$imports) {
+		const found = findAttributeGroup(name, imported);
+		if (found) return found;
+	}
+}
+/**
+* Strip namespace prefix from a QName (e.g., "tns:PersonType" -> "PersonType")
+*/
+function stripNsPrefix(name) {
+	const colonIndex = name.indexOf(":");
+	return colonIndex >= 0 ? name.slice(colonIndex + 1) : name;
+}
+/**
+* Check if element/group has maxOccurs > 1 (is array)
+*/
+function isArray(item) {
+	if (item.maxOccurs === "unbounded") return true;
+	if (typeof item.maxOccurs === "number") return item.maxOccurs > 1;
+	if (typeof item.maxOccurs === "string") {
+		if (item.maxOccurs === "unbounded") return true;
+		const num = parseInt(item.maxOccurs, 10);
+		return !isNaN(num) && num > 1;
+	}
+	return false;
+}
+/**
+* Check if an element is abstract
+*/
+function isAbstractElement(element) {
+	return element.abstract === true || element.abstract === "true";
+}
+/**
+* Find all elements that substitute for a given abstract element.
+* This handles XSD substitution groups where concrete elements can
+* substitute for an abstract element.
+*/
+function findSubstitutes(abstractElementName, schema) {
+	const substitutes = [];
+	for (const { element } of walkTopLevelElements(schema)) {
+		const subGroup = element.substitutionGroup;
+		if (subGroup) {
+			if (stripNsPrefix(subGroup) === abstractElementName) substitutes.push(element);
+		}
+	}
+	return substitutes;
+}
+
+//#endregion
+//#region src/xml/parse.ts
+/**
+* XML Parser for W3C Schema
+*
+* Parse XML string to typed JavaScript object using W3C-compliant Schema definition.
+* Uses the walker module for schema traversal.
+*/
+/**
+* Find all elements that substitute for a given abstract element
+* Searches current schema and all $imports
+*/
+function findSubstitutingElements(abstractElementName, schema) {
+	const results = [];
+	const checkSchema = (s) => {
+		const elements = s.element;
+		if (!elements) return;
+		for (const el of elements) if (el.substitutionGroup) {
+			if (stripNsPrefix(el.substitutionGroup) === abstractElementName) results.push({
+				element: el,
+				schema: s
+			});
+		}
+	};
+	checkSchema(schema);
+	const imports = schema.$imports;
+	if (imports) for (const imported of imports) {
+		checkSchema(imported);
+		const nestedResults = findSubstitutingElements(abstractElementName, imported);
+		results.push(...nestedResults);
+	}
+	return results;
+}
+/**
+* Check if an element is abstract
+* Searches current schema and all $imports
+*/
+function isAbstractElement$1(elementName, schema) {
+	const elements = schema.element;
+	if (elements) {
+		for (const el of elements) if (el.name === elementName && el.abstract === true) return true;
+	}
+	const imports = schema.$imports;
+	if (imports) {
+		for (const imported of imports) if (isAbstractElement$1(elementName, imported)) return true;
+	}
+	return false;
+}
+/**
+* Parse XML string to typed object using schema definition
+*/
+function parse(schema, xml) {
+	const root = new DOMParser().parseFromString(xml, "text/xml")?.documentElement;
+	if (!root) throw new Error("Invalid XML: missing root element");
+	const rootLocalName = getLocalName(root);
+	const elementEntry = findElementByName(schema, rootLocalName);
+	if (!elementEntry) throw new Error(`Schema missing element declaration for: ${rootLocalName}`);
+	const inlineComplexType = elementEntry.element.complexType;
+	if (inlineComplexType) {
+		const content = parseElement(root, inlineComplexType, elementEntry.schema, schema);
+		return { [rootLocalName]: content };
+	}
+	const typeName = stripNsPrefix(elementEntry.element.type || elementEntry.element.name || "");
+	const typeEntry = findComplexType(typeName, schema);
+	if (!typeEntry) throw new Error(`Schema missing complexType for: ${typeName}`);
+	const content = parseElement(root, typeEntry.ct, typeEntry.schema, schema);
+	return { [rootLocalName]: content };
+}
+/**
+* Find element declaration by name (case-insensitive fallback)
+*/
+function findElementByName(schema, name) {
+	const exact = findElement(name, schema);
+	if (exact) return exact;
+	const elements = schema.element;
+	if (elements) {
+		const lowerName = name.toLowerCase();
+		const found = elements.find((el) => el.name?.toLowerCase() === lowerName);
+		if (found) return {
+			element: found,
+			schema
+		};
+	}
+}
+/**
+* Parse a single element using its complexType definition
+* Uses walker to iterate elements and attributes (handles inheritance automatically)
+* @param node - The XML element to parse
+* @param typeDef - The complexType definition for this element
+* @param schema - The schema where typeDef is defined (for type resolution)
+* @param rootSchema - The root schema (for substitution group lookups)
+*/
+function parseElement(node, typeDef, schema, rootSchema) {
+	const result = {};
+	if (typeDef.simpleContent?.extension) return parseSimpleContent(node, typeDef, schema, rootSchema);
+	for (const { attribute } of walkAttributes(typeDef, schema)) {
+		if (!attribute.name) continue;
+		const value = getAttributeValue(node, attribute.name);
+		if (value !== null) result[attribute.name] = convertValue(value, attribute.type || "string");
+		else if (attribute.default !== void 0) result[attribute.name] = convertValue(String(attribute.default), attribute.type || "string");
+	}
+	for (const { element, array } of walkElements(typeDef, schema)) {
+		const resolved = resolveElementInfo$1(element, schema);
+		if (!resolved) continue;
+		if (isAbstractElement$1(resolved.name, rootSchema)) {
+			const substitutes = findSubstitutingElements(resolved.name, rootSchema);
+			const allChildren = getAllChildElements(node);
+			for (const child of allChildren) {
+				const childName = getLocalName(child);
+				const substitute = substitutes.find((s) => s.element.name === childName);
+				if (substitute && substitute.element.name) {
+					const subTypeName = substitute.element.type ? stripNsPrefix(substitute.element.type) : void 0;
+					result[substitute.element.name] = parseChildValue(child, subTypeName, substitute.schema, rootSchema);
+				}
+			}
+		} else {
+			const children = getChildElements(node, resolved.name);
+			if (array || children.length > 1) {
+				const values = children.map((child) => parseChildValue(child, resolved.typeName, schema, rootSchema));
+				if (values.length > 0) result[resolved.name] = values;
+			} else if (children.length === 1) result[resolved.name] = parseChildValue(children[0], resolved.typeName, schema, rootSchema);
+		}
+	}
+	return result;
+}
+/**
+* Parse simpleContent (text content with attributes)
+*/
+function parseSimpleContent(node, typeDef, _schema, _rootSchema) {
+	const result = {};
+	const simpleContent = typeDef.simpleContent;
+	if (!simpleContent?.extension) return result;
+	const ext = simpleContent.extension;
+	result.$value = convertValue(getTextContent(node), ext.base ? stripNsPrefix(ext.base) : "string");
+	if (ext.attribute) for (const attrDef of ext.attribute) {
+		if (!attrDef.name) continue;
+		const value = getAttributeValue(node, attrDef.name);
+		if (value !== null) result[attrDef.name] = convertValue(value, attrDef.type || "string");
+		else if (attrDef.default !== void 0) result[attrDef.name] = convertValue(String(attrDef.default), attrDef.type || "string");
+	}
+	return result;
+}
+/**
+* Resolve element info (name and type), handling ref
+*/
+function resolveElementInfo$1(element, schema) {
+	if (element.name) return {
+		name: element.name,
+		typeName: element.type ? stripNsPrefix(element.type) : void 0
+	};
+	if (element.ref) {
+		const refName = stripNsPrefix(element.ref);
+		const refElement = findElement(refName, schema);
+		if (refElement) return {
+			name: refElement.element.name ?? refName,
+			typeName: refElement.element.type ? stripNsPrefix(refElement.element.type) : void 0
+		};
+		return {
+			name: refName,
+			typeName: void 0
+		};
+	}
+}
+/**
+* Parse a child element's value (either complex type or simple value)
+*/
+function parseChildValue(child, typeName, schema, rootSchema) {
+	const nestedType = typeName ? findComplexType(typeName, schema) : void 0;
+	if (nestedType) return parseElement(child, nestedType.ct, nestedType.schema, rootSchema);
+	return convertValue(getTextContent(child) || "", typeName || "string");
+}
+/**
+* Convert string value to typed value based on XSD type
+*/
+function convertValue(value, type) {
+	switch (stripNsPrefix(type)) {
+		case "int":
+		case "integer":
+		case "decimal":
+		case "float":
+		case "double":
+		case "short":
+		case "long":
+		case "byte":
+		case "unsignedInt":
+		case "unsignedShort":
+		case "unsignedLong":
+		case "unsignedByte":
+		case "positiveInteger":
+		case "negativeInteger":
+		case "nonPositiveInteger":
+		case "nonNegativeInteger": return Number(value);
+		case "boolean": return value === "true" || value === "1";
+		case "date":
+		case "dateTime": return value;
+		default: return value;
+	}
+}
+
+//#endregion
+//#region src/xml/build-utils.ts
+/**
+* Get namespace prefix from schema $xmlns declarations
+*/
+function getSchemaPrefix(schema) {
+	if (!schema.$xmlns || !schema.targetNamespace) return void 0;
+	for (const [prefix, uri] of Object.entries(schema.$xmlns)) if (uri === schema.targetNamespace && prefix) return prefix;
+}
+/**
+* Create XML document with namespace
+*/
+function createXmlDocument(schema) {
+	const impl = new DOMImplementation();
+	const ns = schema.targetNamespace || null;
+	return impl.createDocument(ns, "", null);
+}
+/**
+* Collect namespace declarations from a schema and its $imports/$includes recursively.
+*
+* Gathers all $xmlns prefix→URI mappings from the schema tree.
+* Unused declarations are cleaned up later by stripUnusedNamespaces()
+* after the XML tree is built — that approach is generic and doesn't
+* require any domain-specific knowledge.
+*/
+function collectAllNamespaces(schema, collected = /* @__PURE__ */ new Map(), visited = /* @__PURE__ */ new Set()) {
+	if (visited.has(schema)) return collected;
+	visited.add(schema);
+	if (schema.$xmlns) {
+		for (const [pfx, uri] of Object.entries(schema.$xmlns)) if (!collected.has(pfx)) collected.set(pfx, uri);
+	}
+	const imports = schema.$imports;
+	if (imports) for (const imported of imports) collectAllNamespaces(imported, collected, visited);
+	const includes = schema.$includes;
+	if (includes) for (const included of includes) collectAllNamespaces(included, collected, visited);
+	return collected;
+}
+/**
+* Create root element with namespace declarations
+*
+* When elementFormDefault="unqualified", the root element should NOT have
+* a namespace prefix. This is important for formats like abapGit where
+* the root element (abapGit) is unqualified but child elements may have prefixes.
+*/
+function createRootElement(doc, elementName, schema, prefix) {
+	const ns = schema.targetNamespace || null;
+	const usePrefix = schema.elementFormDefault === "unqualified" ? void 0 : prefix;
+	const rootTag = usePrefix ? `${usePrefix}:${elementName}` : elementName;
+	const root = doc.createElement(rootTag);
+	if (ns && prefix) root.setAttribute(`xmlns:${prefix}`, ns);
+	else if (ns && !prefix) root.setAttribute("xmlns", ns);
+	const allNamespaces = collectAllNamespaces(schema);
+	for (const [pfx, uri] of allNamespaces) if (pfx && pfx !== prefix) root.setAttribute(`xmlns:${pfx}`, uri);
+	else if (!pfx) root.setAttribute("xmlns", uri);
+	return root;
+}
+/**
+* Remove xmlns declarations from the root element for prefixes that are
+* not actually used anywhere in the document tree.
+*
+* This prevents emitting unused namespace declarations (e.g. xmlns:abapsource,
+* xmlns:abapoo) that come from the schema's $imports chain but aren't
+* referenced by any element or attribute in the built XML.
+*
+* The prefix that maps to the schema's own targetNamespace is always
+* preserved — even when elementFormDefault="unqualified" causes the root
+* element to be emitted without a prefix, the xmlns declaration is still
+* required for the document to be in the correct namespace.
+*/
+/**
+* Add namespace prefix from a qualified name to the set (if present).
+*/
+function addPrefixFromName(name, usedPrefixes) {
+	const colon = name.indexOf(":");
+	if (colon > 0) usedPrefixes.add(name.substring(0, colon));
+}
+/**
+* Collect namespace prefixes referenced by attributes on a single element
+* (xmlns declarations are skipped — they declare rather than use prefixes).
+*/
+function collectPrefixesFromAttributes(node, usedPrefixes) {
+	if (!node.attributes) return;
+	for (const attr of Array.from(node.attributes)) if (!attr.name.startsWith("xmlns:") && attr.name !== "xmlns") addPrefixFromName(attr.name, usedPrefixes);
+}
+/**
+* Collect prefixes used by elements and attributes in the tree (recursive walk).
+*/
+function collectUsedPrefixes(node, usedPrefixes) {
+	addPrefixFromName(node.tagName, usedPrefixes);
+	collectPrefixesFromAttributes(node, usedPrefixes);
+	if (node.childNodes) {
+		for (const child of Array.from(node.childNodes)) if (child.nodeType === 1) collectUsedPrefixes(child, usedPrefixes);
+	}
+}
+/**
+* Collect xmlns:prefix attribute names on the root element whose prefix
+* is not in the used-prefixes set.
+*/
+function findUnusedXmlnsAttrs(root, usedPrefixes) {
+	const toRemove = [];
+	if (!root.attributes) return toRemove;
+	for (const attr of Array.from(root.attributes)) if (attr.name.startsWith("xmlns:")) {
+		const pfx = attr.name.substring(6);
+		if (!usedPrefixes.has(pfx)) toRemove.push(attr.name);
+	}
+	return toRemove;
+}
+function stripUnusedNamespaces(root, schema) {
+	const usedPrefixes = /* @__PURE__ */ new Set();
+	if (schema?.targetNamespace && schema.$xmlns) {
+		for (const [pfx, uri] of Object.entries(schema.$xmlns)) if (pfx && uri === schema.targetNamespace) usedPrefixes.add(pfx);
+	}
+	collectUsedPrefixes(root, usedPrefixes);
+	for (const name of findUnusedXmlnsAttrs(root, usedPrefixes)) root.removeAttribute(name);
+}
+/**
+* Format value for XML output
+*/
+function formatValue(value, type) {
+	if (value instanceof Date) return stripNsPrefix(type) === "date" ? value.toISOString().split("T")[0] : value.toISOString();
+	if (typeof value === "boolean") return value ? "true" : "false";
+	return String(value);
+}
+/**
+* Simple XML formatter (basic indentation)
+*
+* Keeps text content inline: <tag>text</tag>
+* Only adds newlines for nested elements
+*/
+function formatXml(xml) {
+	let formatted = "";
+	let indent = 0;
+	const parts = [];
+	let pos = 0;
+	while (pos < xml.length) if (xml.charCodeAt(pos) === 60) {
+		const end = xml.indexOf(">", pos + 1);
+		if (end === -1) {
+			parts.push(xml.slice(pos));
+			break;
+		}
+		parts.push(xml.slice(pos, end + 1));
+		pos = end + 1;
+	} else {
+		const next = xml.indexOf("<", pos);
+		if (next === -1) {
+			parts.push(xml.slice(pos));
+			break;
+		}
+		if (next > pos) parts.push(xml.slice(pos, next));
+		pos = next;
+	}
+	let lastWasText = false;
+	for (let i = 0; i < parts.length; i++) {
+		const part = parts[i];
+		const nextPart = parts[i + 1];
+		if (part.startsWith("<?")) {
+			formatted += part + "\n";
+			lastWasText = false;
+		} else if (part.startsWith("</")) {
+			indent = Math.max(0, indent - 1);
+			if (lastWasText) formatted += part + "\n";
+			else formatted += "  ".repeat(indent) + part + "\n";
+			lastWasText = false;
+		} else if (part.startsWith("<") && part.endsWith("/>")) {
+			formatted += "  ".repeat(indent) + part + "\n";
+			lastWasText = false;
+		} else if (part.startsWith("<")) {
+			formatted += "  ".repeat(indent) + part;
+			if (!part.includes("</")) indent++;
+			if (nextPart && !nextPart.startsWith("<")) {} else formatted += "\n";
+			lastWasText = false;
+		} else {
+			const trimmed = part.trim();
+			if (trimmed) {
+				formatted += trimmed;
+				lastWasText = true;
+			}
+		}
+	}
+	return formatted.trim();
+}
+
+//#endregion
+//#region src/xml/build.ts
+/**
+* XML Builder for W3C Schema (Walker-based implementation)
+*
+* Build XML string from typed JavaScript object using W3C-compliant Schema definition.
+* Uses the walker module for schema traversal.
+*/
+/**
+* Collect all namespace prefixes from a schema and its $imports chain
+*/
+function collectAllXmlns(schema, visited = /* @__PURE__ */ new Set()) {
+	if (visited.has(schema)) return {};
+	visited.add(schema);
+	const result = {};
+	const xmlns = schema.$xmlns;
+	if (xmlns) Object.assign(result, xmlns);
+	const imports = schema.$imports;
+	if (imports) for (const imported of imports) Object.assign(result, collectAllXmlns(imported, visited));
+	return result;
+}
+/**
+* Get the namespace prefix for a schema's targetNamespace from the root schema's $xmlns
+* and all imported schemas' $xmlns (for inherited attributes)
+*/
+function getPrefixForSchema(schema, rootSchema) {
+	const targetNs = schema.targetNamespace;
+	if (!targetNs) return void 0;
+	const allXmlns = collectAllXmlns(rootSchema);
+	for (const [prefix, ns] of Object.entries(allXmlns)) if (ns === targetNs) return prefix;
+}
+/**
+* Build XML string from typed object using schema definition
+*/
+function build(schema, data, options = {}) {
+	const { xmlDecl = true, encoding = "utf-8", pretty = false } = options;
+	const prefix = options.prefix ?? getSchemaPrefix(schema);
+	const doc = createXmlDocument(schema);
+	let elementDecl;
+	let elementSchema = schema;
+	let elementData = data;
+	if (options.rootElement) {
+		const found = findElement(options.rootElement, schema);
+		if (!found) throw new Error(`Element '${options.rootElement}' not found in schema`);
+		elementDecl = found.element;
+		elementSchema = found.schema;
+		if (elementData[options.rootElement] !== void 0) elementData = elementData[options.rootElement];
+	} else {
+		const dataKeys = Object.keys(elementData);
+		if (dataKeys.length === 1) {
+			const potentialElementName = dataKeys[0];
+			const found = findElement(potentialElementName, schema);
+			if (found) {
+				elementDecl = found.element;
+				elementSchema = found.schema;
+				elementData = elementData[potentialElementName];
+			}
+		}
+		if (!elementDecl) {
+			elementDecl = findMatchingElement(elementData, schema);
+			if (!elementDecl) throw new Error("Schema has no element declarations");
+		}
+	}
+	let rootType;
+	let rootSchema = elementSchema;
+	if (elementDecl.complexType) rootType = elementDecl.complexType;
+	else if (elementDecl.type) {
+		const typeName = stripNsPrefix(elementDecl.type);
+		const rootTypeEntry = findComplexType(typeName, elementSchema);
+		if (!rootTypeEntry) throw new Error(`Schema missing complexType for: ${typeName}`);
+		rootType = rootTypeEntry.ct;
+		rootSchema = rootTypeEntry.schema;
+	} else throw new Error(`Element ${elementDecl.name} has no type or inline complexType`);
+	const elementName = elementDecl.name ?? elementDecl.ref;
+	if (!elementName) throw new Error("Element declaration has no name or ref");
+	const root = createRootElement(doc, elementName, schema, prefix);
+	buildElement(doc, root, elementData, rootType, rootSchema, schema, prefix);
+	stripUnusedNamespaces(root, schema);
+	if (!root.hasChildNodes()) root.appendChild(doc.createTextNode(""));
+	doc.appendChild(root);
+	let xml = new XMLSerializer().serializeToString(doc);
+	if (xmlDecl) xml = `<?xml version="1.0" encoding="${encoding}"?>\n${xml}`;
+	if (pretty) xml = formatXml(xml);
+	return xml;
+}
+/**
+* Find the element declaration that best matches the data structure.
+* Searches in the main schema first, then in $imports.
+*/
+function findMatchingElement(data, schema) {
+	const dataKeys = new Set(Object.keys(data));
+	let bestMatch;
+	let bestScore = -1;
+	const scoreElement = (element, searchSchema) => {
+		let ct;
+		let ctSchema = searchSchema;
+		if (element.complexType) ct = element.complexType;
+		else if (element.type) {
+			const typeEntry = findComplexType(stripNsPrefix(element.type), searchSchema);
+			if (typeEntry) {
+				ct = typeEntry.ct;
+				ctSchema = typeEntry.schema;
+			}
+		}
+		if (!ct) return 0;
+		const typeFields = /* @__PURE__ */ new Set();
+		for (const { element: el } of walkElements(ct, ctSchema)) if (el.name) typeFields.add(el.name);
+		for (const { attribute } of walkAttributes(ct, ctSchema)) if (attribute.name) typeFields.add(attribute.name);
+		let score = 0;
+		dataKeys.forEach((key) => {
+			if (typeFields.has(key)) score++;
+		});
+		return score;
+	};
+	const elements = schema.element;
+	if (elements && elements.length > 0) for (const element of elements) {
+		const score = scoreElement(element, schema);
+		if (score > bestScore) {
+			bestScore = score;
+			bestMatch = element;
+		}
+	}
+	const imports = schema.$imports;
+	if (imports) for (const importedSchema of imports) {
+		const importedElements = importedSchema.element;
+		if (!importedElements) continue;
+		for (const element of importedElements) {
+			const score = scoreElement(element, importedSchema);
+			if (score > bestScore) {
+				bestScore = score;
+				bestMatch = element;
+			}
+		}
+	}
+	if (!bestMatch && elements && elements.length > 0) return elements[0];
+	return bestMatch;
+}
+/**
+* Build element content using its complexType definition
+* Uses walker to iterate elements and attributes (handles inheritance automatically)
+* @param rootSchema - The original schema passed to build(), used for substitution group lookup
+*/
+function buildElement(doc, node, data, typeDef, schema, rootSchema, prefix) {
+	for (const { attribute, schema: attrSchema } of walkAttributes(typeDef, schema)) {
+		if (!attribute.name) continue;
+		const value = data[attribute.name];
+		if (value !== void 0 && value !== null) {
+			const attributeFormDefault = attrSchema.attributeFormDefault;
+			const attrForm = attribute.form;
+			let attrName = attribute.name;
+			if (attrForm === "qualified" || attrForm !== "unqualified" && attributeFormDefault === "qualified") {
+				const attrPrefix = getPrefixForSchema(attrSchema, rootSchema);
+				if (attrPrefix) attrName = `${attrPrefix}:${attribute.name}`;
+			}
+			node.setAttribute(attrName, formatValue(value, attribute.type || "string"));
+		}
+	}
+	for (const { element, schema: elementDefSchema } of walkElements(typeDef, schema)) {
+		if (element.ref) {
+			const refName = stripNsPrefix(element.ref);
+			const refElement = findElement(refName, elementDefSchema);
+			if (refElement && refElement.element.abstract) {
+				const substitutes = findSubstitutes$1(refName, rootSchema);
+				for (const substitute of substitutes) {
+					const subName = substitute.element.name;
+					if (!subName) continue;
+					const value = data[subName];
+					if (value !== void 0) buildField(doc, node, value, subName, substitute.element.type ? stripNsPrefix(substitute.element.type) : void 0, substitute.schema, rootSchema, prefix);
+				}
+				continue;
+			}
+		}
+		const resolved = resolveElementInfo(element, elementDefSchema);
+		if (!resolved) continue;
+		const value = data[resolved.dataKey];
+		if (value !== void 0) buildFieldWithTagName(doc, node, value, resolved.tagName, resolved.typeName, resolved.inlineComplexType, resolved.elementSchema, rootSchema, prefix, resolved.form);
+	}
+}
+/**
+* Resolve element info (name and type), handling ref
+*
+* Returns:
+* - tagName: The XML tag name to use (may include prefix like "asx:abap")
+* - dataKey: The key to look up in data object (local name without prefix)
+* - typeName: The type name for building nested content (if type attribute)
+* - inlineComplexType: The inline complexType definition (if present)
+* - elementSchema: The schema where the element was found
+* - form: Per-element form override ("qualified" or "unqualified")
+*/
+function resolveElementInfo(element, schema) {
+	if (element.name) return {
+		tagName: element.name,
+		dataKey: element.name,
+		typeName: element.type ? stripNsPrefix(element.type) : void 0,
+		inlineComplexType: element.complexType,
+		elementSchema: schema,
+		form: element.form
+	};
+	if (element.ref) {
+		const refName = stripNsPrefix(element.ref);
+		const refElement = findElement(refName, schema);
+		if (refElement) return {
+			tagName: element.ref,
+			dataKey: refElement.element.name ?? refName,
+			typeName: refElement.element.type ? stripNsPrefix(refElement.element.type) : void 0,
+			inlineComplexType: refElement.element.complexType,
+			elementSchema: refElement.schema,
+			form: void 0
+		};
+		return {
+			tagName: element.ref,
+			dataKey: refName,
+			typeName: void 0,
+			inlineComplexType: void 0,
+			elementSchema: schema,
+			form: void 0
+		};
+	}
+}
+/**
+* Build a field (child element)
+*
+* Respects elementFormDefault:
+* - "qualified": local elements get namespace prefix
+* - "unqualified" (default): local elements do NOT get namespace prefix
+*/
+function buildField(doc, parent, value, elementName, typeName, schema, rootSchema, prefix) {
+	if (value === void 0 || value === null) return;
+	const nestedType = typeName ? findComplexType(typeName, schema) : void 0;
+	const usePrefix = rootSchema.elementFormDefault === "qualified" ? prefix : void 0;
+	const tagName = usePrefix ? `${usePrefix}:${elementName}` : elementName;
+	if (Array.isArray(value)) for (const item of value) {
+		const child = doc.createElement(tagName);
+		if (nestedType) buildElement(doc, child, item, nestedType.ct, nestedType.schema, rootSchema, prefix);
+		else {
+			const text = formatValue(item, typeName || "string");
+			if (text) child.appendChild(doc.createTextNode(text));
+		}
+		parent.appendChild(child);
+	}
+	else {
+		const child = doc.createElement(tagName);
+		if (nestedType) buildElement(doc, child, value, nestedType.ct, nestedType.schema, rootSchema, prefix);
+		else {
+			const text = formatValue(value, typeName || "string");
+			if (text) child.appendChild(doc.createTextNode(text));
+		}
+		parent.appendChild(child);
+	}
+}
+/**
+* Build a field with an explicit tag name (used for element refs with prefix)
+*
+* Handles three cases:
+* 1. Element refs with prefix (e.g., ref="asx:abap") - use tagName directly
+* 2. Elements with form="unqualified" - never use prefix
+* 3. Direct elements - apply elementFormDefault logic
+*/
+function buildFieldWithTagName(doc, parent, value, tagName, typeName, inlineComplexType, elementSchema, rootSchema, prefix, elementForm) {
+	if (value === void 0 || value === null) return;
+	let nestedType;
+	if (inlineComplexType) nestedType = {
+		ct: inlineComplexType,
+		schema: elementSchema
+	};
+	else if (typeName) nestedType = findComplexType(typeName, elementSchema);
+	let actualTagName = tagName;
+	if (!tagName.includes(":")) {
+		let usePrefix;
+		if (elementForm === "unqualified") usePrefix = void 0;
+		else if (elementForm === "qualified") usePrefix = getPrefixForSchema(elementSchema, rootSchema) ?? prefix;
+		else usePrefix = (elementSchema.elementFormDefault ?? rootSchema.elementFormDefault) === "qualified" ? getPrefixForSchema(elementSchema, rootSchema) ?? prefix : void 0;
+		actualTagName = usePrefix ? `${usePrefix}:${tagName}` : tagName;
+	}
+	if (Array.isArray(value)) for (const item of value) {
+		const child = doc.createElement(actualTagName);
+		if (nestedType) buildElement(doc, child, item, nestedType.ct, nestedType.schema, rootSchema, prefix);
+		else {
+			const text = formatValue(item, typeName || "string");
+			if (text) child.appendChild(doc.createTextNode(text));
+		}
+		parent.appendChild(child);
+	}
+	else {
+		const child = doc.createElement(actualTagName);
+		if (nestedType) buildElement(doc, child, value, nestedType.ct, nestedType.schema, rootSchema, prefix);
+		else {
+			const text = formatValue(value, typeName || "string");
+			if (text) child.appendChild(doc.createTextNode(text));
+		}
+		parent.appendChild(child);
+	}
+}
+/**
+* Find all elements that substitute for a given abstract element name.
+* Searches in the main schema and all $imports.
+*/
+function findSubstitutes$1(abstractElementName, schema) {
+	const substitutes = [];
+	const searchSchema = (s) => {
+		const elements = s.element;
+		if (!elements) return;
+		for (const el of elements) if (el.substitutionGroup) {
+			if (stripNsPrefix(el.substitutionGroup) === abstractElementName) substitutes.push({
+				element: el,
+				schema: s
+			});
+		}
+	};
+	searchSchema(schema);
+	const imports = schema.$imports;
+	if (imports) for (const imported of imports) searchSchema(imported);
+	return substitutes;
+}
+
+//#endregion
+//#region src/xml/typed.ts
+/**
+* Create a typed schema wrapper
+*
+* @param schema - Raw schema literal (with `as const`)
+* @returns Typed schema with parse/build methods
+*
+* @example
+* ```typescript
+* // Infer type from schema
+* const personSchema = typedSchema(rawPersonSchema);
+* const person = personSchema.parse(xml);
+*
+* // Or with explicit type
+* const personSchema = typedSchema<PersonType>(rawPersonSchema);
+* ```
+*/
+function typedSchema(schema) {
+	return {
+		_type: null,
+		schema,
+		parse(xml) {
+			return parse(schema, xml);
+		},
+		build(data, options) {
+			return build(schema, data, options);
+		}
+	};
+}
+
+//#endregion
+export { SchemaResolver, SchemaTraverser, build as buildXml, buildXsd, createSchemaLoader, defaultLoader, defineConfig, deriveRootTypeName, findComplexType, findElement, findSimpleType, findSubstitutes, generateInterfaces, generateSchemaFile, generateSchemaLiteral, getSubstitutes, isAbstractElement, linkSchema, linkSchemas, loadAndLinkSchema, loadSchema, parseXsd as parse, parseXsd, parseSchemaContent, parse as parseXml, resolveImports, resolveSchema, resolveSchemaTypes, runCodegen, stripNsPrefix, typedSchema, walkAttributes, walkComplexTypes, walkElements, walkSimpleTypes, walkTopLevelElements };
+//# sourceMappingURL=index.mjs.map