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

package/README.md

@@ -102,11 +102,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 +299,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.1
  * (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",
@@ -1775,7 +1776,7 @@ function buildSchemaModel(doc, options = {}) {
     }
     const externalRoot = getSchemaRoot(externalDoc);
     const externalDeclaredTargetNamespace = externalRoot?.getAttribute("targetNamespace") || null;
-    const shouldApplyChameleonInclude = ref.kind === "include" && (schema.targetNamespace || null) !== null && externalDeclaredTargetNamespace === null;
+    const shouldApplyChameleonInclude = ref.kind === "include" && externalDeclaredTargetNamespace === null;
     const externalBuild = buildSchemaModel(externalDoc, {
       ...options,
       xsdText: externalXsdText,
@@ -2400,6 +2401,9 @@ function runSchemaDiagnostics(schema, options = {}) {
   };
 }
 
+// src/version.js
+var ENGINE_VERSION = "v0.1.0-rc.1";
+
 // src/utils/result.js
 function summarizeIssues(issues = []) {
   return issues.reduce(
@@ -2420,7 +2424,8 @@ function makeResult({ data = null, issues = [] } = {}) {
     ok: !hasErrors(issues),
     data,
     issues,
-    summary: summarizeIssues(issues)
+    summary: summarizeIssues(issues),
+    version: ENGINE_VERSION
   };
 }
 
@@ -4805,6 +4810,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 +4848,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.1
  * (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",
@@ -1802,7 +1803,7 @@ var UssXsdEngine = (() => {
       }
       const externalRoot = getSchemaRoot(externalDoc);
       const externalDeclaredTargetNamespace = externalRoot?.getAttribute("targetNamespace") || null;
-      const shouldApplyChameleonInclude = ref.kind === "include" && (schema.targetNamespace || null) !== null && externalDeclaredTargetNamespace === null;
+      const shouldApplyChameleonInclude = ref.kind === "include" && externalDeclaredTargetNamespace === null;
       const externalBuild = buildSchemaModel(externalDoc, {
         ...options,
         xsdText: externalXsdText,
@@ -2427,6 +2428,9 @@ var UssXsdEngine = (() => {
     };
   }
 
+  // src/version.js
+  var ENGINE_VERSION = "v0.1.0-rc.1";
+
   // src/utils/result.js
   function summarizeIssues(issues = []) {
     return issues.reduce(
@@ -2447,7 +2451,8 @@ var UssXsdEngine = (() => {
       ok: !hasErrors(issues),
       data,
       issues,
-      summary: summarizeIssues(issues)
+      summary: summarizeIssues(issues),
+      version: ENGINE_VERSION
     };
   }
 
@@ -4832,6 +4837,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 +4875,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.1",
   "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",