uss-xsd-engine 0.2.1 → 0.2.2

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

@@ -1,5 +1,5 @@
 /*!
- * uss-xsd-engine v0.2.1
+ * uss-xsd-engine v0.2.2
  * (c) 2026 Bernard Mumble
  * MIT License
  */
@@ -103,7 +103,9 @@ var ISSUE_CODES = {
   XSD_INCLUDE_NOT_PROVIDED: "XSD_INCLUDE_NOT_PROVIDED",
   XSD_IMPORT_NOT_PROVIDED: "XSD_IMPORT_NOT_PROVIDED",
   XSD_INCLUDE_NAMESPACE_MISMATCH: "XSD_INCLUDE_NAMESPACE_MISMATCH",
-  XSD_IMPORT_NAMESPACE_MISMATCH: "XSD_IMPORT_NAMESPACE_MISMATCH"
+  XSD_IMPORT_NAMESPACE_MISMATCH: "XSD_IMPORT_NAMESPACE_MISMATCH",
+  XSD_REDEFINE_NAMESPACE_MISMATCH: "XSD_REDEFINE_NAMESPACE_MISMATCH",
+  REDEFINE_INVALID_OVERRIDE: "REDEFINE_INVALID_OVERRIDE"
 };
 
 // src/parser/parseXsd.js
@@ -156,6 +158,7 @@ function createEmptySchemaModel() {
     targetNamespace: null,
     elementFormDefault: null,
     attributeFormDefault: null,
+    schemaVersion: null,
     namespaces: {
       default: null,
       prefixes: /* @__PURE__ */ Object.create(null)
@@ -171,7 +174,8 @@ function createEmptySchemaModel() {
     documents: [],
     externalRefs: {
       includes: [],
-      imports: []
+      imports: [],
+      redefines: []
     },
     importedSchemas: [],
     roots: [],
@@ -204,6 +208,16 @@ function normalizeUse(value) {
   }
   return null;
 }
+function createAnnotation({
+  documentation = null,
+  appinfo = null
+} = {}) {
+  return {
+    kind: "annotation",
+    documentation,
+    appinfo
+  };
+}
 function createElementDecl({
   name = null,
   qName = null,
@@ -217,6 +231,7 @@ function createElementDecl({
   fixedValue = null,
   nillable = false,
   identityConstraints = [],
+  annotation = null,
   line = null,
   column = null,
   path = null
@@ -235,6 +250,7 @@ function createElementDecl({
     fixedValue,
     nillable,
     identityConstraints,
+    annotation,
     line,
     column,
     path
@@ -250,6 +266,7 @@ function createAttributeDecl({
   use = null,
   defaultValue = null,
   fixedValue = null,
+  annotation = null,
   line = null,
   column = null,
   path = null
@@ -265,6 +282,7 @@ function createAttributeDecl({
     use,
     defaultValue,
     fixedValue,
+    annotation,
     line,
     column,
     path
@@ -281,6 +299,7 @@ function createComplexTypeDecl({
   mixed = false,
   abstract = false,
   identityConstraints = [],
+  annotation = null,
   line = null,
   column = null,
   path = null
@@ -297,6 +316,7 @@ function createComplexTypeDecl({
     mixed,
     abstract,
     identityConstraints,
+    annotation,
     line,
     column,
     path
@@ -309,6 +329,7 @@ function createSimpleTypeDecl({
   baseTypeName = null,
   facets = {},
   enumerations = [],
+  annotation = null,
   line = null,
   column = null,
   path = null
@@ -321,6 +342,7 @@ function createSimpleTypeDecl({
     baseTypeName,
     facets,
     enumerations,
+    annotation,
     line,
     column,
     path
@@ -368,6 +390,7 @@ function createAttributeGroupDecl({
 }
 function createAttributeGroupRef({
   refName,
+  use = null,
   line = null,
   column = null,
   path = null
@@ -375,6 +398,7 @@ function createAttributeGroupRef({
   return {
     kind: "attributeGroupRef",
     refName,
+    use,
     line,
     column,
     path
@@ -846,7 +870,6 @@ function getEffectiveContent(schema, complexTypeDecl) {
 
 // src/parser/buildSchemaModel.js
 var UNSUPPORTED_NODE_FEATURES = /* @__PURE__ */ new Set([
-  "redefine",
   "notation"
 ]);
 function elementChildren(node) {
@@ -867,6 +890,8 @@ function recordExternalRef(schema, kind, node, path, loc) {
     schema.externalRefs.includes.push(entry);
   } else if (kind === "import") {
     schema.externalRefs.imports.push(entry);
+  } else if (kind === "redefine") {
+    schema.externalRefs.redefines.push(entry);
   }
 }
 function mergeGlobalsIntoSchema(targetSchema, sourceSchema, issues, createDuplicateIssue) {
@@ -907,6 +932,9 @@ function mergeGlobalsIntoSchema(targetSchema, sourceSchema, issues, createDuplic
   targetSchema.externalRefs.imports.push(
     ...sourceSchema.externalRefs.imports || []
   );
+  targetSchema.externalRefs.redefines.push(
+    ...sourceSchema.externalRefs.redefines || []
+  );
   targetSchema.importedSchemas.push(...sourceSchema.importedSchemas || []);
   targetSchema.identityConstraints.push(
     ...sourceSchema.identityConstraints || []
@@ -1180,6 +1208,42 @@ function parseFacets(node) {
   }
   return { facets, enumerations };
 }
+function parseAnnotation(node) {
+  if (!node || node.localName !== "annotation") {
+    return null;
+  }
+  const children = Array.from(node.children || []).filter(
+    (child) => child.nodeType === 1
+  );
+  let documentation = null;
+  let appinfo = null;
+  for (const child of children) {
+    if (child.localName === "documentation") {
+      const lang = child.getAttribute("xml:lang") || null;
+      const source = child.getAttribute("source") || null;
+      const text = (child.textContent || "").trim();
+      documentation = {
+        text,
+        lang,
+        source
+      };
+    } else if (child.localName === "appinfo") {
+      const source = child.getAttribute("source") || null;
+      const text = (child.textContent || "").trim();
+      appinfo = {
+        text,
+        source
+      };
+    }
+  }
+  if (!documentation && !appinfo) {
+    return null;
+  }
+  return createAnnotation({
+    documentation,
+    appinfo
+  });
+}
 function parseSimpleType(node, xsdText, lineStarts, parentPath, schema, issues) {
   const path = buildPath(parentPath, node);
   const loc = locateNodeInSource(xsdText, lineStarts, node);
@@ -1187,7 +1251,12 @@ function parseSimpleType(node, xsdText, lineStarts, parentPath, schema, issues)
   let baseTypeName = null;
   let facets = {};
   let enumerations = [];
-  const restriction = elementChildren(node).find(
+  const children = elementChildren(node);
+  const annotationNode = children.find(
+    (child) => child.localName === "annotation"
+  );
+  const annotation = parseAnnotation(annotationNode);
+  const restriction = children.find(
     (child) => child.localName === "restriction"
   );
   if (restriction) {
@@ -1214,6 +1283,7 @@ function parseSimpleType(node, xsdText, lineStarts, parentPath, schema, issues)
     baseTypeName,
     facets,
     enumerations,
+    annotation,
     line: loc.line,
     column: loc.column,
     path
@@ -1223,7 +1293,12 @@ function parseAttribute(node, xsdText, lineStarts, parentPath, schema, issues) {
   const path = buildPath(parentPath, node);
   const loc = locateNodeInSource(xsdText, lineStarts, node);
   collectNodeDiagnostics(schema, issues, node, path, loc);
-  const inlineSimpleTypeNode = elementChildren(node).find(
+  const children = elementChildren(node);
+  const annotationNode = children.find(
+    (child) => child.localName === "annotation"
+  );
+  const annotation = parseAnnotation(annotationNode);
+  const inlineSimpleTypeNode = children.find(
     (child) => child.localName === "simpleType"
   );
   const inlineType = inlineSimpleTypeNode ? parseSimpleType(
@@ -1246,6 +1321,7 @@ function parseAttribute(node, xsdText, lineStarts, parentPath, schema, issues) {
     use: normalizeUse(node.getAttribute("use")),
     defaultValue: node.getAttribute("default"),
     fixedValue: node.getAttribute("fixed"),
+    annotation,
     line: loc.line,
     column: loc.column,
     path
@@ -1257,6 +1333,7 @@ function parseAttributeGroupRef(node, xsdText, lineStarts, parentPath, schema, i
   collectNodeDiagnostics(schema, issues, node, path, loc);
   return createAttributeGroupRef({
     refName: node.getAttribute("ref"),
+    use: normalizeUse(node.getAttribute("use")),
     line: loc.line,
     column: loc.column,
     path
@@ -1294,6 +1371,10 @@ function parseElement(node, xsdText, lineStarts, parentPath, schema, issues) {
   collectNodeDiagnostics(schema, issues, node, path, loc);
   let inlineType = null;
   const children = elementChildren(node);
+  const annotationNode = children.find(
+    (child) => child.localName === "annotation"
+  );
+  const annotation = parseAnnotation(annotationNode);
   const inlineComplexTypeNode = children.find(
     (child) => child.localName === "complexType"
   );
@@ -1349,6 +1430,7 @@ function parseElement(node, xsdText, lineStarts, parentPath, schema, issues) {
     fixedValue: node.getAttribute("fixed"),
     nillable: node.getAttribute("nillable") === "true",
     identityConstraints,
+    annotation,
     line: loc.line,
     column: loc.column,
     path
@@ -1609,6 +1691,10 @@ function parseComplexType(node, xsdText, lineStarts, parentPath, schema, issues)
   let contentModel = "complex";
   const children = elementChildren(node);
   const namespaceUri4 = schema.targetNamespace || null;
+  const annotationNode = children.find(
+    (child) => child.localName === "annotation"
+  );
+  const annotation = parseAnnotation(annotationNode);
   const identityConstraints = children.filter(
     (child) => ["key", "keyref", "unique"].includes(child.localName)
   ).map(
@@ -1694,6 +1780,7 @@ function parseComplexType(node, xsdText, lineStarts, parentPath, schema, issues)
     mixed: node.getAttribute("mixed") === "true",
     abstract: node.getAttribute("abstract") === "true",
     identityConstraints,
+    annotation,
     line: loc.line,
     column: loc.column,
     path
@@ -1763,6 +1850,63 @@ function isImportNamespaceCompatible(ref, importedSchema) {
   }
   return (declaredNs || null) === (importedNs || null);
 }
+function isRedefineNamespaceCompatible(hostSchema, redefinedSchema) {
+  const hostNs = hostSchema?.targetNamespace || null;
+  const redefinedNs = redefinedSchema?.targetNamespace || null;
+  return hostNs === redefinedNs;
+}
+function mergeRedefinesIntoSchema(targetSchema, sourceSchema, issues, createDuplicateIssue) {
+  const buckets = [
+    ["complexTypes", "DUPLICATE_GLOBAL_COMPLEX_TYPE"],
+    ["simpleTypes", "DUPLICATE_GLOBAL_SIMPLE_TYPE"],
+    ["groups", "DUPLICATE_GLOBAL_GROUP"],
+    ["attributeGroups", "DUPLICATE_GLOBAL_ATTRIBUTE_GROUP"]
+  ];
+  for (const [bucketName, _duplicateCode] of buckets) {
+    for (const [key, decl] of Object.entries(
+      sourceSchema.globals[bucketName] || {}
+    )) {
+      if (targetSchema.globals[bucketName][key]) {
+        targetSchema.globals[bucketName][key] = {
+          ...decl,
+          redefined: true,
+          originalDefinition: targetSchema.globals[bucketName][key]
+        };
+      } else {
+        issues.push(
+          createIssue({
+            code: ISSUE_CODES.REDEFINE_INVALID_OVERRIDE,
+            severity: "error",
+            message: `xs:redefine attempts to override ${bucketName.slice(0, -1)} '${decl.name}' which does not exist in the base schema.`,
+            line: decl.line,
+            column: decl.column,
+            path: decl.path,
+            source: "xsd",
+            nodeKind: decl.kind,
+            name: decl.name,
+            details: { declarationName: decl.name }
+          })
+        );
+      }
+    }
+  }
+  targetSchema.references.types.push(...sourceSchema.references.types || []);
+  targetSchema.references.baseTypes.push(
+    ...sourceSchema.references.baseTypes || []
+  );
+  targetSchema.references.groupRefs.push(
+    ...sourceSchema.references.groupRefs || []
+  );
+  targetSchema.references.attributeGroupRefs.push(
+    ...sourceSchema.references.attributeGroupRefs || []
+  );
+  for (const feature of sourceSchema.usedFeatures || []) {
+    targetSchema.usedFeatures.add(feature);
+  }
+  targetSchema.unsupportedFeatures.push(
+    ...sourceSchema.unsupportedFeatures || []
+  );
+}
 function normalizeSchemaPath(value) {
   if (!value || typeof value !== "string") return null;
   const trimmed = value.trim();
@@ -1888,6 +2032,7 @@ function buildSchemaModel(doc, options = {}) {
   schema.targetNamespace = getEffectiveTargetNamespace(schemaRoot, options);
   schema.elementFormDefault = schemaRoot.getAttribute("elementFormDefault");
   schema.attributeFormDefault = schemaRoot.getAttribute("attributeFormDefault");
+  schema.schemaVersion = schemaRoot.getAttribute("version");
   extractNamespaces(schemaRoot, schema);
   const rootPath = "/schema";
   const rootLoc = locateNodeInSource(xsdText, lineStarts, schemaRoot);
@@ -2040,6 +2185,13 @@ function buildSchemaModel(doc, options = {}) {
         recordExternalRef(schema, "import", child, path, loc);
         break;
       }
+      case "redefine": {
+        const path = buildPath(rootPath, child);
+        const loc = locateNodeInSource(xsdText, lineStarts, child);
+        collectNodeDiagnostics(schema, issues, child, path, loc);
+        recordExternalRef(schema, "redefine", child, path, loc);
+        break;
+      }
       default: {
         const path = buildPath(rootPath, child);
         const loc = locateNodeInSource(xsdText, lineStarts, child);
@@ -2064,7 +2216,8 @@ function buildSchemaModel(doc, options = {}) {
   const visited = options._visitedExternalSchemas || /* @__PURE__ */ new Set();
   const includes = schema.externalRefs.includes || [];
   const imports = schema.externalRefs.imports || [];
-  for (const ref of [...includes, ...imports]) {
+  const redefines = schema.externalRefs.redefines || [];
+  for (const ref of [...includes, ...imports, ...redefines]) {
     if (!ref.schemaLocation) continue;
     const resolution = resolveExternalDocument(ref, externalDocuments);
     if (resolution.kind === "ambiguous-namespace") {
@@ -2191,6 +2344,34 @@ function buildSchemaModel(doc, options = {}) {
         } else {
           schema.importedSchemas.push(externalBuild.schema);
         }
+      } else if (ref.kind === "redefine") {
+        if (!isRedefineNamespaceCompatible(schema, externalBuild.schema)) {
+          issues.push(
+            createIssue({
+              code: ISSUE_CODES.XSD_REDEFINE_NAMESPACE_MISMATCH,
+              severity: "error",
+              message: `xs:redefine namespace mismatch. Host targetNamespace is '${schema.targetNamespace || ""}', redefined schema targetNamespace is '${externalBuild.schema.targetNamespace || ""}'.`,
+              line: ref.line,
+              column: ref.column,
+              path: ref.path,
+              source: "xsd",
+              nodeKind: "redefine",
+              details: {
+                schemaLocation: ref.schemaLocation,
+                resolvedSchemaKey,
+                hostTargetNamespace: schema.targetNamespace || null,
+                redefinedTargetNamespace: externalBuild.schema.targetNamespace || null
+              }
+            })
+          );
+        } else {
+          mergeRedefinesIntoSchema(
+            schema,
+            externalBuild.schema,
+            issues,
+            createDuplicateIssue
+          );
+        }
       }
     }
     issues.push(...externalBuild.issues || []);
@@ -3245,7 +3426,7 @@ function runSchemaDiagnostics(schema, options = {}) {
 }
 
 // src/version.js
-var ENGINE_VERSION = "v0.2.1";
+var ENGINE_VERSION = "v0.2.2";
 
 // src/utils/result.js
 function summarizeIssues(issues = []) {

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

@@ -1,5 +1,5 @@
 /*!
- * uss-xsd-engine v0.2.1
+ * uss-xsd-engine v0.2.2
  * (c) 2026 Bernard Mumble
  * MIT License
  */
@@ -130,7 +130,9 @@ var UssXsdEngine = (() => {
     XSD_INCLUDE_NOT_PROVIDED: "XSD_INCLUDE_NOT_PROVIDED",
     XSD_IMPORT_NOT_PROVIDED: "XSD_IMPORT_NOT_PROVIDED",
     XSD_INCLUDE_NAMESPACE_MISMATCH: "XSD_INCLUDE_NAMESPACE_MISMATCH",
-    XSD_IMPORT_NAMESPACE_MISMATCH: "XSD_IMPORT_NAMESPACE_MISMATCH"
+    XSD_IMPORT_NAMESPACE_MISMATCH: "XSD_IMPORT_NAMESPACE_MISMATCH",
+    XSD_REDEFINE_NAMESPACE_MISMATCH: "XSD_REDEFINE_NAMESPACE_MISMATCH",
+    REDEFINE_INVALID_OVERRIDE: "REDEFINE_INVALID_OVERRIDE"
   };
 
   // src/parser/parseXsd.js
@@ -183,6 +185,7 @@ var UssXsdEngine = (() => {
       targetNamespace: null,
       elementFormDefault: null,
       attributeFormDefault: null,
+      schemaVersion: null,
       namespaces: {
         default: null,
         prefixes: /* @__PURE__ */ Object.create(null)
@@ -198,7 +201,8 @@ var UssXsdEngine = (() => {
       documents: [],
       externalRefs: {
         includes: [],
-        imports: []
+        imports: [],
+        redefines: []
       },
       importedSchemas: [],
       roots: [],
@@ -231,6 +235,16 @@ var UssXsdEngine = (() => {
     }
     return null;
   }
+  function createAnnotation({
+    documentation = null,
+    appinfo = null
+  } = {}) {
+    return {
+      kind: "annotation",
+      documentation,
+      appinfo
+    };
+  }
   function createElementDecl({
     name = null,
     qName = null,
@@ -244,6 +258,7 @@ var UssXsdEngine = (() => {
     fixedValue = null,
     nillable = false,
     identityConstraints = [],
+    annotation = null,
     line = null,
     column = null,
     path = null
@@ -262,6 +277,7 @@ var UssXsdEngine = (() => {
       fixedValue,
       nillable,
       identityConstraints,
+      annotation,
       line,
       column,
       path
@@ -277,6 +293,7 @@ var UssXsdEngine = (() => {
     use = null,
     defaultValue = null,
     fixedValue = null,
+    annotation = null,
     line = null,
     column = null,
     path = null
@@ -292,6 +309,7 @@ var UssXsdEngine = (() => {
       use,
       defaultValue,
       fixedValue,
+      annotation,
       line,
       column,
       path
@@ -308,6 +326,7 @@ var UssXsdEngine = (() => {
     mixed = false,
     abstract = false,
     identityConstraints = [],
+    annotation = null,
     line = null,
     column = null,
     path = null
@@ -324,6 +343,7 @@ var UssXsdEngine = (() => {
       mixed,
       abstract,
       identityConstraints,
+      annotation,
       line,
       column,
       path
@@ -336,6 +356,7 @@ var UssXsdEngine = (() => {
     baseTypeName = null,
     facets = {},
     enumerations = [],
+    annotation = null,
     line = null,
     column = null,
     path = null
@@ -348,6 +369,7 @@ var UssXsdEngine = (() => {
       baseTypeName,
       facets,
       enumerations,
+      annotation,
       line,
       column,
       path
@@ -395,6 +417,7 @@ var UssXsdEngine = (() => {
   }
   function createAttributeGroupRef({
     refName,
+    use = null,
     line = null,
     column = null,
     path = null
@@ -402,6 +425,7 @@ var UssXsdEngine = (() => {
     return {
       kind: "attributeGroupRef",
       refName,
+      use,
       line,
       column,
       path
@@ -873,7 +897,6 @@ var UssXsdEngine = (() => {
 
   // src/parser/buildSchemaModel.js
   var UNSUPPORTED_NODE_FEATURES = /* @__PURE__ */ new Set([
-    "redefine",
     "notation"
   ]);
   function elementChildren(node) {
@@ -894,6 +917,8 @@ var UssXsdEngine = (() => {
       schema.externalRefs.includes.push(entry);
     } else if (kind === "import") {
       schema.externalRefs.imports.push(entry);
+    } else if (kind === "redefine") {
+      schema.externalRefs.redefines.push(entry);
     }
   }
   function mergeGlobalsIntoSchema(targetSchema, sourceSchema, issues, createDuplicateIssue) {
@@ -934,6 +959,9 @@ var UssXsdEngine = (() => {
     targetSchema.externalRefs.imports.push(
       ...sourceSchema.externalRefs.imports || []
     );
+    targetSchema.externalRefs.redefines.push(
+      ...sourceSchema.externalRefs.redefines || []
+    );
     targetSchema.importedSchemas.push(...sourceSchema.importedSchemas || []);
     targetSchema.identityConstraints.push(
       ...sourceSchema.identityConstraints || []
@@ -1207,6 +1235,42 @@ var UssXsdEngine = (() => {
     }
     return { facets, enumerations };
   }
+  function parseAnnotation(node) {
+    if (!node || node.localName !== "annotation") {
+      return null;
+    }
+    const children = Array.from(node.children || []).filter(
+      (child) => child.nodeType === 1
+    );
+    let documentation = null;
+    let appinfo = null;
+    for (const child of children) {
+      if (child.localName === "documentation") {
+        const lang = child.getAttribute("xml:lang") || null;
+        const source = child.getAttribute("source") || null;
+        const text = (child.textContent || "").trim();
+        documentation = {
+          text,
+          lang,
+          source
+        };
+      } else if (child.localName === "appinfo") {
+        const source = child.getAttribute("source") || null;
+        const text = (child.textContent || "").trim();
+        appinfo = {
+          text,
+          source
+        };
+      }
+    }
+    if (!documentation && !appinfo) {
+      return null;
+    }
+    return createAnnotation({
+      documentation,
+      appinfo
+    });
+  }
   function parseSimpleType(node, xsdText, lineStarts, parentPath, schema, issues) {
     const path = buildPath(parentPath, node);
     const loc = locateNodeInSource(xsdText, lineStarts, node);
@@ -1214,7 +1278,12 @@ var UssXsdEngine = (() => {
     let baseTypeName = null;
     let facets = {};
     let enumerations = [];
-    const restriction = elementChildren(node).find(
+    const children = elementChildren(node);
+    const annotationNode = children.find(
+      (child) => child.localName === "annotation"
+    );
+    const annotation = parseAnnotation(annotationNode);
+    const restriction = children.find(
       (child) => child.localName === "restriction"
     );
     if (restriction) {
@@ -1241,6 +1310,7 @@ var UssXsdEngine = (() => {
       baseTypeName,
       facets,
       enumerations,
+      annotation,
       line: loc.line,
       column: loc.column,
       path
@@ -1250,7 +1320,12 @@ var UssXsdEngine = (() => {
     const path = buildPath(parentPath, node);
     const loc = locateNodeInSource(xsdText, lineStarts, node);
     collectNodeDiagnostics(schema, issues, node, path, loc);
-    const inlineSimpleTypeNode = elementChildren(node).find(
+    const children = elementChildren(node);
+    const annotationNode = children.find(
+      (child) => child.localName === "annotation"
+    );
+    const annotation = parseAnnotation(annotationNode);
+    const inlineSimpleTypeNode = children.find(
       (child) => child.localName === "simpleType"
     );
     const inlineType = inlineSimpleTypeNode ? parseSimpleType(
@@ -1273,6 +1348,7 @@ var UssXsdEngine = (() => {
       use: normalizeUse(node.getAttribute("use")),
       defaultValue: node.getAttribute("default"),
       fixedValue: node.getAttribute("fixed"),
+      annotation,
       line: loc.line,
       column: loc.column,
       path
@@ -1284,6 +1360,7 @@ var UssXsdEngine = (() => {
     collectNodeDiagnostics(schema, issues, node, path, loc);
     return createAttributeGroupRef({
       refName: node.getAttribute("ref"),
+      use: normalizeUse(node.getAttribute("use")),
       line: loc.line,
       column: loc.column,
       path
@@ -1321,6 +1398,10 @@ var UssXsdEngine = (() => {
     collectNodeDiagnostics(schema, issues, node, path, loc);
     let inlineType = null;
     const children = elementChildren(node);
+    const annotationNode = children.find(
+      (child) => child.localName === "annotation"
+    );
+    const annotation = parseAnnotation(annotationNode);
     const inlineComplexTypeNode = children.find(
       (child) => child.localName === "complexType"
     );
@@ -1376,6 +1457,7 @@ var UssXsdEngine = (() => {
       fixedValue: node.getAttribute("fixed"),
       nillable: node.getAttribute("nillable") === "true",
       identityConstraints,
+      annotation,
       line: loc.line,
       column: loc.column,
       path
@@ -1636,6 +1718,10 @@ var UssXsdEngine = (() => {
     let contentModel = "complex";
     const children = elementChildren(node);
     const namespaceUri4 = schema.targetNamespace || null;
+    const annotationNode = children.find(
+      (child) => child.localName === "annotation"
+    );
+    const annotation = parseAnnotation(annotationNode);
     const identityConstraints = children.filter(
       (child) => ["key", "keyref", "unique"].includes(child.localName)
     ).map(
@@ -1721,6 +1807,7 @@ var UssXsdEngine = (() => {
       mixed: node.getAttribute("mixed") === "true",
       abstract: node.getAttribute("abstract") === "true",
       identityConstraints,
+      annotation,
       line: loc.line,
       column: loc.column,
       path
@@ -1790,6 +1877,63 @@ var UssXsdEngine = (() => {
     }
     return (declaredNs || null) === (importedNs || null);
   }
+  function isRedefineNamespaceCompatible(hostSchema, redefinedSchema) {
+    const hostNs = hostSchema?.targetNamespace || null;
+    const redefinedNs = redefinedSchema?.targetNamespace || null;
+    return hostNs === redefinedNs;
+  }
+  function mergeRedefinesIntoSchema(targetSchema, sourceSchema, issues, createDuplicateIssue) {
+    const buckets = [
+      ["complexTypes", "DUPLICATE_GLOBAL_COMPLEX_TYPE"],
+      ["simpleTypes", "DUPLICATE_GLOBAL_SIMPLE_TYPE"],
+      ["groups", "DUPLICATE_GLOBAL_GROUP"],
+      ["attributeGroups", "DUPLICATE_GLOBAL_ATTRIBUTE_GROUP"]
+    ];
+    for (const [bucketName, _duplicateCode] of buckets) {
+      for (const [key, decl] of Object.entries(
+        sourceSchema.globals[bucketName] || {}
+      )) {
+        if (targetSchema.globals[bucketName][key]) {
+          targetSchema.globals[bucketName][key] = {
+            ...decl,
+            redefined: true,
+            originalDefinition: targetSchema.globals[bucketName][key]
+          };
+        } else {
+          issues.push(
+            createIssue({
+              code: ISSUE_CODES.REDEFINE_INVALID_OVERRIDE,
+              severity: "error",
+              message: `xs:redefine attempts to override ${bucketName.slice(0, -1)} '${decl.name}' which does not exist in the base schema.`,
+              line: decl.line,
+              column: decl.column,
+              path: decl.path,
+              source: "xsd",
+              nodeKind: decl.kind,
+              name: decl.name,
+              details: { declarationName: decl.name }
+            })
+          );
+        }
+      }
+    }
+    targetSchema.references.types.push(...sourceSchema.references.types || []);
+    targetSchema.references.baseTypes.push(
+      ...sourceSchema.references.baseTypes || []
+    );
+    targetSchema.references.groupRefs.push(
+      ...sourceSchema.references.groupRefs || []
+    );
+    targetSchema.references.attributeGroupRefs.push(
+      ...sourceSchema.references.attributeGroupRefs || []
+    );
+    for (const feature of sourceSchema.usedFeatures || []) {
+      targetSchema.usedFeatures.add(feature);
+    }
+    targetSchema.unsupportedFeatures.push(
+      ...sourceSchema.unsupportedFeatures || []
+    );
+  }
   function normalizeSchemaPath(value) {
     if (!value || typeof value !== "string") return null;
     const trimmed = value.trim();
@@ -1915,6 +2059,7 @@ var UssXsdEngine = (() => {
     schema.targetNamespace = getEffectiveTargetNamespace(schemaRoot, options);
     schema.elementFormDefault = schemaRoot.getAttribute("elementFormDefault");
     schema.attributeFormDefault = schemaRoot.getAttribute("attributeFormDefault");
+    schema.schemaVersion = schemaRoot.getAttribute("version");
     extractNamespaces(schemaRoot, schema);
     const rootPath = "/schema";
     const rootLoc = locateNodeInSource(xsdText, lineStarts, schemaRoot);
@@ -2067,6 +2212,13 @@ var UssXsdEngine = (() => {
           recordExternalRef(schema, "import", child, path, loc);
           break;
         }
+        case "redefine": {
+          const path = buildPath(rootPath, child);
+          const loc = locateNodeInSource(xsdText, lineStarts, child);
+          collectNodeDiagnostics(schema, issues, child, path, loc);
+          recordExternalRef(schema, "redefine", child, path, loc);
+          break;
+        }
         default: {
           const path = buildPath(rootPath, child);
           const loc = locateNodeInSource(xsdText, lineStarts, child);
@@ -2091,7 +2243,8 @@ var UssXsdEngine = (() => {
     const visited = options._visitedExternalSchemas || /* @__PURE__ */ new Set();
     const includes = schema.externalRefs.includes || [];
     const imports = schema.externalRefs.imports || [];
-    for (const ref of [...includes, ...imports]) {
+    const redefines = schema.externalRefs.redefines || [];
+    for (const ref of [...includes, ...imports, ...redefines]) {
       if (!ref.schemaLocation) continue;
       const resolution = resolveExternalDocument(ref, externalDocuments);
       if (resolution.kind === "ambiguous-namespace") {
@@ -2218,6 +2371,34 @@ var UssXsdEngine = (() => {
           } else {
             schema.importedSchemas.push(externalBuild.schema);
           }
+        } else if (ref.kind === "redefine") {
+          if (!isRedefineNamespaceCompatible(schema, externalBuild.schema)) {
+            issues.push(
+              createIssue({
+                code: ISSUE_CODES.XSD_REDEFINE_NAMESPACE_MISMATCH,
+                severity: "error",
+                message: `xs:redefine namespace mismatch. Host targetNamespace is '${schema.targetNamespace || ""}', redefined schema targetNamespace is '${externalBuild.schema.targetNamespace || ""}'.`,
+                line: ref.line,
+                column: ref.column,
+                path: ref.path,
+                source: "xsd",
+                nodeKind: "redefine",
+                details: {
+                  schemaLocation: ref.schemaLocation,
+                  resolvedSchemaKey,
+                  hostTargetNamespace: schema.targetNamespace || null,
+                  redefinedTargetNamespace: externalBuild.schema.targetNamespace || null
+                }
+              })
+            );
+          } else {
+            mergeRedefinesIntoSchema(
+              schema,
+              externalBuild.schema,
+              issues,
+              createDuplicateIssue
+            );
+          }
         }
       }
       issues.push(...externalBuild.issues || []);
@@ -3272,7 +3453,7 @@ var UssXsdEngine = (() => {
   }
 
   // src/version.js
-  var ENGINE_VERSION = "v0.2.1";
+  var ENGINE_VERSION = "v0.2.2";
 
   // src/utils/result.js
   function summarizeIssues(issues = []) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uss-xsd-engine",
-  "version": "0.2.1",
+  "version": "0.2.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",