uss-xsd-engine 0.1.0-beta.5 → 0.1.0-rc.2

package/README.md

@@ -5,6 +5,9 @@ Browser-first XSD engine for schema diagnostics, tree extraction, sample XML gen
 ---
 
 ![npm](https://img.shields.io/npm/v/uss-xsd-engine)
+![dw](https://img.shields.io/npm/dw/uss-xsd-engine)
+![dm](https://img.shields.io/npm/dm/uss-xsd-engine)
+![dy](https://img.shields.io/npm/dy/uss-xsd-engine)
 [![Jsdelivr](https://data.jsdelivr.com/v1/package/npm/uss-xsd-engine/badge)](https://www.jsdelivr.com/package/npm/uss-xsd-engine)
 
 ---
@@ -102,11 +105,11 @@ console.log(result.issues);
 ### CDN/Browser
 
 ```HTML
-<script src="https://unpkg.com/uss-xsd-engine@0.1.0-beta.5/dist/uss-xsd-engine.standalone.js"></script>
+<script src="https://unpkg.com/uss-xsd-engine@latest/dist/uss-xsd-engine.standalone.js"></script>
 
 or
 
-<script src="https://cdn.jsdelivr.net/npm/uss-xsd-engine@0.1.0-beta.5/dist/uss-xsd-engine.esm.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/uss-xsd-engine@latest/dist/uss-xsd-engine.esm.min.js"></script>
 
 <script>
   const result = UssXsdEngine.getSchemaDiagnostics({ xsdText });
@@ -299,38 +302,64 @@ Use **uss-xsd-engine** if you need:
 ---
 
 ## ⚠️ Supported vs Not Fully Supported
-### ✅ Supported (v0.1.x)
-- Most common XSD structures
-- Namespace-aware resolution
+### ✅ Supported (v0.1.x / RC)
+- XSD parsing into an internal schema model
+- Namespace-aware resolution (elements, types, attributes, groups)
 - Extensions (`xs:extension`)
-- Restrictions (subset + occurrence checks)
-- Facet validation (including pattern)
-- Default / fixed semantics
-- Include/import (manual provision with recursive resolution)
-- Sample XML generation (namespace-aware, multi-schema support)
-- XML validation (structure, facets, and source-mapped diagnostics)
+- Restrictions (subset enforcement, occurrence narrowing, attribute constraints)
+- Facet validation:
+  - length, numeric, pattern, enumeration, digits
+- Default / fixed semantics (schema + XML validation)
+- Include/import:
+  - manual provision via `externalDocuments`
+  - recursive resolution
+  - strict namespace enforcement
+- Chameleon includes (namespace adoption for no-targetNamespace schemas)
+- Namespace-aware sample XML generation:
+  - minimal + representative modes
+  - pattern-aware generation (e.g., UETR, BIC)
+- XML validation:
+  - structural validation (sequence, choice, all, groups)
+  - simpleContent + complexContent enforcement
+  - mixed content handling
+  - restriction validation (pass 2)
+- Root and nested `simpleContent` validation alignment
 - XML parse diagnostics with line/column support
-- Semantic validation diagnostics with line/column support
-- Attribute and value-level source mapping
+- Semantic XML diagnostics with line/column support
+- Attribute, value, and text source mapping
 - Namespace-aware schema tree extraction
+- Imported schema isolation with namespace-safe lookup
+- QName resolution:
+  - prefixed + default namespace handling
+  - no cross-namespace leakage
 
 ---
 
 ## ⚠️ Partially Supported / In Progress
-- Deep sample XML expansion (choice branching, recursion depth)
-- Full restriction theorem validation (advanced edge cases)
-- Advanced Namespace handling (prefix customizatioon, default namespace strategies)
-- Advanced wildcard (`xs:any`, `xs:anyAttribute`)
-- Attribute namespace qualification
+- Deep sample XML expansion:
+  - complex choice branching
+  - recursion depth control
+- Full restriction theorem validation:
+  - advanced edge cases (beyond practical subset checks)
+- Advanced wildcard handling:
+  - `xs:any`
+  - `xs:anyAttribute`
+- Attribute namespace qualification edge cases
 
 ---
 
 ## ❌ Not Supported Yet
-- Identity constraints (`xs:key`, `xs:keyref`, `xs:unique`)
+- Identity constraints:
+  - `xs:key`
+  - `xs:keyref`
+  - `xs:unique`
+- `xs:redefine`
 - Automatic network fetching of schemas
-- Full W3C spec conformance (edge-case completeness)
-- Streaming validation for very large XML
-- Chameleon includes (namespace adaptation)
+  - (engine is intentionally browser-first and caller-driven)
+- Full W3C spec completeness
+  - (focus is practical + real-world coverage)
+- Streaming / incremental validation for very large XML
+
 
 ---
 

package/dist/uss-xsd-engine.esm.js

@@ -1,5 +1,5 @@
 /*!
- * uss-xsd-engine v0.1.0-beta.5
+ * uss-xsd-engine v0.1.0-rc.2
  * (c) 2026 Bernard Mumble
  * MIT License
  */
@@ -60,6 +60,7 @@ var ISSUE_CODES = {
   XML_INVALID_TEXT_FOR_COMPLEX_TYPE: "XML_INVALID_TEXT_FOR_COMPLEX_TYPE",
   XML_VALUE_INVALID: "XML_VALUE_INVALID",
   XML_ENUMERATION_MISMATCH: "XML_ENUMERATION_MISMATCH",
+  XML_VALUE_REQUIRED: "XML_VALUE_REQUIRED",
   XML_PATTERN_MISMATCH: "XML_PATTERN_MISMATCH",
   XML_LENGTH_MISMATCH: "XML_LENGTH_MISMATCH",
   XML_MIN_LENGTH_VIOLATION: "XML_MIN_LENGTH_VIOLATION",
@@ -1523,7 +1524,7 @@ function parseAttributeGroup(node, xsdText, lineStarts, parentPath, schema, issu
   });
 }
 function getEffectiveTargetNamespace(schemaRoot, options = {}) {
-  if (Object.prototype.hasOwnProperty.call(options, "_overrideTargetNamespace")) {
+  if (Object.prototype.hasOwnProperty.call(options, "_overrideTargetNamespace") && options._overrideTargetNamespace !== void 0) {
     return options._overrideTargetNamespace;
   }
   return schemaRoot.getAttribute("targetNamespace");
@@ -1534,12 +1535,12 @@ function isIncludeNamespaceCompatible(hostSchema, includedSchema) {
   return hostNs === includedNs;
 }
 function isImportNamespaceCompatible(ref, importedSchema) {
-  const declaredNs = ref?.namespace || null;
-  const importedNs = importedSchema?.targetNamespace || null;
+  const declaredNs = ref && Object.prototype.hasOwnProperty.call(ref, "namespace") ? ref.namespace : null;
+  const importedNs = importedSchema && Object.prototype.hasOwnProperty.call(importedSchema, "targetNamespace") ? importedSchema.targetNamespace : null;
   if (!declaredNs) {
     return true;
   }
-  return declaredNs === importedNs;
+  return (declaredNs || null) === (importedNs || null);
 }
 function buildSchemaModel(doc, options = {}) {
   const issues = [];
@@ -1774,16 +1775,21 @@ function buildSchemaModel(doc, options = {}) {
       continue;
     }
     const externalRoot = getSchemaRoot(externalDoc);
-    const externalDeclaredTargetNamespace = externalRoot?.getAttribute("targetNamespace") || null;
-    const shouldApplyChameleonInclude = ref.kind === "include" && (schema.targetNamespace || null) !== null && externalDeclaredTargetNamespace === null;
+    const externalDeclaredTargetNamespace = externalRoot?.hasAttribute(
+      "targetNamespace"
+    ) ? externalRoot.getAttribute("targetNamespace") : null;
+    const shouldApplyChameleonInclude = ref.kind === "include" && externalDeclaredTargetNamespace === null;
     const externalBuild = buildSchemaModel(externalDoc, {
       ...options,
       xsdText: externalXsdText,
       externalDocuments,
       _visitedExternalSchemas: visited,
-      _overrideTargetNamespace: shouldApplyChameleonInclude ? schema.targetNamespace : void 0
+      ...shouldApplyChameleonInclude ? { _overrideTargetNamespace: schema.targetNamespace } : {}
     });
     if (externalBuild.schema) {
+      if (ref.kind === "import") {
+        schema.importedSchemas.push(externalBuild.schema);
+      }
       if (ref.kind === "include") {
         if (!isIncludeNamespaceCompatible(schema, externalBuild.schema)) {
           issues.push(
@@ -2400,6 +2406,9 @@ function runSchemaDiagnostics(schema, options = {}) {
   };
 }
 
+// src/version.js
+var ENGINE_VERSION = "v0.1.0-rc.2";
+
 // src/utils/result.js
 function summarizeIssues(issues = []) {
   return issues.reduce(
@@ -2420,7 +2429,8 @@ function makeResult({ data = null, issues = [] } = {}) {
     ok: !hasErrors(issues),
     data,
     issues,
-    summary: summarizeIssues(issues)
+    summary: summarizeIssues(issues),
+    version: ENGINE_VERSION
   };
 }
 
@@ -4805,6 +4815,27 @@ function validateXmlAgainstSchema(schema, xmlText, options = {}, helpers = {}) {
     const isSimpleContent = resolvedRootType?.contentModel === "simple" && resolvedRootType?.derivation?.baseTypeName;
     if (isSimpleContent) {
       const textValue = (xmlRoot.textContent || "").trim();
+      const children2 = elementChildren3(xmlRoot);
+      if (children2.length > 0) {
+        for (const childNode of children2) {
+          const childName = localName2(childNode);
+          issues.push(
+            createIssue({
+              code: ISSUE_CODES.XML_UNEXPECTED_ELEMENT,
+              severity: "error",
+              message: `Unexpected element '${childName}'.`,
+              ...toLocationFields(locator.getNodeLocation(childNode)),
+              path: `/${xmlRootName}/${childName}`,
+              source: "xml",
+              nodeKind: "element",
+              name: childName,
+              details: {
+                namespaceUri: namespaceUri2(childNode)
+              }
+            })
+          );
+        }
+      }
       if (!textValue) {
         issues.push(
           createIssue({
@@ -4822,10 +4853,6 @@ function validateXmlAgainstSchema(schema, xmlText, options = {}, helpers = {}) {
           })
         );
       } else {
-        const baseType = resolveType(
-          schema,
-          resolvedRootType.derivation.baseTypeName
-        );
         const valueResult = validateElementValue(
           schema,
           { ...schemaRoot, typeName: resolvedRootType.derivation.baseTypeName },

package/dist/uss-xsd-engine.standalone.js

@@ -1,5 +1,5 @@
 /*!
- * uss-xsd-engine v0.1.0-beta.5
+ * uss-xsd-engine v0.1.0-rc.2
  * (c) 2026 Bernard Mumble
  * MIT License
  */
@@ -87,6 +87,7 @@ var UssXsdEngine = (() => {
     XML_INVALID_TEXT_FOR_COMPLEX_TYPE: "XML_INVALID_TEXT_FOR_COMPLEX_TYPE",
     XML_VALUE_INVALID: "XML_VALUE_INVALID",
     XML_ENUMERATION_MISMATCH: "XML_ENUMERATION_MISMATCH",
+    XML_VALUE_REQUIRED: "XML_VALUE_REQUIRED",
     XML_PATTERN_MISMATCH: "XML_PATTERN_MISMATCH",
     XML_LENGTH_MISMATCH: "XML_LENGTH_MISMATCH",
     XML_MIN_LENGTH_VIOLATION: "XML_MIN_LENGTH_VIOLATION",
@@ -1550,7 +1551,7 @@ var UssXsdEngine = (() => {
     });
   }
   function getEffectiveTargetNamespace(schemaRoot, options = {}) {
-    if (Object.prototype.hasOwnProperty.call(options, "_overrideTargetNamespace")) {
+    if (Object.prototype.hasOwnProperty.call(options, "_overrideTargetNamespace") && options._overrideTargetNamespace !== void 0) {
       return options._overrideTargetNamespace;
     }
     return schemaRoot.getAttribute("targetNamespace");
@@ -1561,12 +1562,12 @@ var UssXsdEngine = (() => {
     return hostNs === includedNs;
   }
   function isImportNamespaceCompatible(ref, importedSchema) {
-    const declaredNs = ref?.namespace || null;
-    const importedNs = importedSchema?.targetNamespace || null;
+    const declaredNs = ref && Object.prototype.hasOwnProperty.call(ref, "namespace") ? ref.namespace : null;
+    const importedNs = importedSchema && Object.prototype.hasOwnProperty.call(importedSchema, "targetNamespace") ? importedSchema.targetNamespace : null;
     if (!declaredNs) {
       return true;
     }
-    return declaredNs === importedNs;
+    return (declaredNs || null) === (importedNs || null);
   }
   function buildSchemaModel(doc, options = {}) {
     const issues = [];
@@ -1801,16 +1802,21 @@ var UssXsdEngine = (() => {
         continue;
       }
       const externalRoot = getSchemaRoot(externalDoc);
-      const externalDeclaredTargetNamespace = externalRoot?.getAttribute("targetNamespace") || null;
-      const shouldApplyChameleonInclude = ref.kind === "include" && (schema.targetNamespace || null) !== null && externalDeclaredTargetNamespace === null;
+      const externalDeclaredTargetNamespace = externalRoot?.hasAttribute(
+        "targetNamespace"
+      ) ? externalRoot.getAttribute("targetNamespace") : null;
+      const shouldApplyChameleonInclude = ref.kind === "include" && externalDeclaredTargetNamespace === null;
       const externalBuild = buildSchemaModel(externalDoc, {
         ...options,
         xsdText: externalXsdText,
         externalDocuments,
         _visitedExternalSchemas: visited,
-        _overrideTargetNamespace: shouldApplyChameleonInclude ? schema.targetNamespace : void 0
+        ...shouldApplyChameleonInclude ? { _overrideTargetNamespace: schema.targetNamespace } : {}
       });
       if (externalBuild.schema) {
+        if (ref.kind === "import") {
+          schema.importedSchemas.push(externalBuild.schema);
+        }
         if (ref.kind === "include") {
           if (!isIncludeNamespaceCompatible(schema, externalBuild.schema)) {
             issues.push(
@@ -2427,6 +2433,9 @@ var UssXsdEngine = (() => {
     };
   }
 
+  // src/version.js
+  var ENGINE_VERSION = "v0.1.0-rc.2";
+
   // src/utils/result.js
   function summarizeIssues(issues = []) {
     return issues.reduce(
@@ -2447,7 +2456,8 @@ var UssXsdEngine = (() => {
       ok: !hasErrors(issues),
       data,
       issues,
-      summary: summarizeIssues(issues)
+      summary: summarizeIssues(issues),
+      version: ENGINE_VERSION
     };
   }
 
@@ -4832,6 +4842,27 @@ ${writeNode(rootNode, 0)}`;
       const isSimpleContent = resolvedRootType?.contentModel === "simple" && resolvedRootType?.derivation?.baseTypeName;
       if (isSimpleContent) {
         const textValue = (xmlRoot.textContent || "").trim();
+        const children2 = elementChildren3(xmlRoot);
+        if (children2.length > 0) {
+          for (const childNode of children2) {
+            const childName = localName2(childNode);
+            issues.push(
+              createIssue({
+                code: ISSUE_CODES.XML_UNEXPECTED_ELEMENT,
+                severity: "error",
+                message: `Unexpected element '${childName}'.`,
+                ...toLocationFields(locator.getNodeLocation(childNode)),
+                path: `/${xmlRootName}/${childName}`,
+                source: "xml",
+                nodeKind: "element",
+                name: childName,
+                details: {
+                  namespaceUri: namespaceUri2(childNode)
+                }
+              })
+            );
+          }
+        }
         if (!textValue) {
           issues.push(
             createIssue({
@@ -4849,10 +4880,6 @@ ${writeNode(rootNode, 0)}`;
             })
           );
         } else {
-          const baseType = resolveType(
-            schema,
-            resolvedRootType.derivation.baseTypeName
-          );
           const valueResult = validateElementValue(
             schema,
             { ...schemaRoot, typeName: resolvedRootType.derivation.baseTypeName },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uss-xsd-engine",
-  "version": "0.1.0-beta.5",
+  "version": "0.1.0-rc.2",
   "description": "Browser-first XSD engine for schema diagnostics, tree extraction, sample XML generation, and XML validation.",
   "type": "module",
   "main": "dist/uss-xsd-engine.esm.js",
@@ -30,6 +30,7 @@
     "url": "https://github.com/mumblebaj/uss-xsd-engine/issues"
   },
   "scripts": {
+    "write": "node scripts/write-version.js",
     "build": "node scripts/build.mjs",
     "clean": "rm -rf dist",
     "check:git": "git diff --quiet && git diff --cached --quiet",