pro-editor-schema 1.1.9 → 1.2.0

package/README.md

@@ -197,12 +197,14 @@ const errors = validateXml(rootElement, elementsToLink, linkElements, [
 
 - Consecutive footnote number checks
 - Consecutive footnote cue checks
+- Possible weblink checks
 
 It also runs per-element checks for:
 
 - Link targets (`linkend`) on linkable elements
 - Uncited bibliographic references
 - Unreferenced footnotes
+- Heading hierarchy
 
 Schema-based attribute and child validation only runs for codes listed in `schemasToValidateAgainst`.
 

package/dist/index.js

@@ -2030,7 +2030,8 @@ var FOOTNOTE_SECTION_SCHEMA = createSchema({
 });
 
 // src/schema/elementSchemas/elements/heading.ts
-var HEADING_ROLES = ["H1", "H2", "H3", "H4", "H5", "H6", "vignette_group"];
+var HEADING_LEVEL = ["H1", "H2", "H3", "H4", "H5", "H6"];
+var HEADING_ROLES = [...HEADING_LEVEL, "vignette_group"];
 var HEADING_SCHEMA = createSchema({
   code: "heading",
   kind: "element",
@@ -2655,23 +2656,22 @@ var retrieveTextIgnoringNodesWithSelector = (element, selector = ".del") => {
   return clonedElement.textContent || "";
 };
 
+// src/validation/utils/isDeletedElement.ts
+var isDeletedElement = (element) => {
+  return !!element.closest(".del");
+};
+
 // src/validation/utils/getElementsSelector.ts
 var getElementsSelector = ({
   element,
   selector,
   filterDeletedNodes
 }) => {
-  const elements = element.querySelectorAll(selector);
+  const elements = Array.from(element.querySelectorAll(selector));
   if (filterDeletedNodes) {
-    return Array.from(elements).filter((element2) => {
-      const hasDeletedParent = element2.closest(".del") !== null;
-      if (hasDeletedParent) {
-        return false;
-      }
-      return true;
-    });
+    return elements.filter((element2) => !isDeletedElement(element2));
   }
-  return Array.from(elements);
+  return elements;
 };
 
 // src/validation/validateLinkend.ts
@@ -3056,6 +3056,76 @@ var validatePossibleWeblinks = (root) => {
   return errors;
 };
 
+// src/validation/utils/getParentElement.ts
+var getParentElement = ({
+  element,
+  schemaCode,
+  filterDeletedNodes
+}) => {
+  let current = element.parentElement;
+  while (current) {
+    const isValidParent = findSchemaByElement(current)?.code === schemaCode;
+    const isFilterDeleted = filterDeletedNodes && isDeletedElement(current);
+    if (isValidParent || isFilterDeleted) {
+      return current;
+    }
+    current = current.parentElement;
+  }
+  return void 0;
+};
+
+// src/validation/validateHeadingHierarchy.ts
+var getHierarchyLevel = (element) => {
+  const role = element.getAttribute("role");
+  if (!role) return void 0;
+  const validHeadingLevel = HEADING_LEVEL.indexOf(role) + 1;
+  if (!validHeadingLevel) return void 0;
+  return validHeadingLevel;
+};
+var validateHeadingHierarchy = (element) => {
+  const errors = [];
+  if (isDeletedElement(element)) {
+    return errors;
+  }
+  const level = getHierarchyLevel(element);
+  if (level === void 0) {
+    return errors;
+  }
+  const parentHeading = getParentElement({
+    element,
+    schemaCode: HEADING_SCHEMA.code,
+    filterDeletedNodes: true
+  });
+  if (!parentHeading) {
+    if (level !== 1) {
+      addValidationIssue(errors, {
+        store: getStore(element),
+        title: "Missing heading H1",
+        kind: "missing",
+        description: `H${level} is not under an H1. Please check the heading hierarchy.`,
+        level: "warning"
+      });
+    }
+    return errors;
+  }
+  const parentLevel = getHierarchyLevel(parentHeading);
+  if (parentLevel === void 0) {
+    return errors;
+  }
+  const expectedLevel = parentLevel + 1;
+  if (level === expectedLevel) {
+    return errors;
+  }
+  addValidationIssue(errors, {
+    store: getStore(element),
+    title: "Invalid heading hierarchy",
+    kind: "forbidden",
+    description: `H${level} cannot follow H${parentLevel} directly. Please check the heading hierarchy.`,
+    level: "warning"
+  });
+  return errors;
+};
+
 // src/validation/validateXml.ts
 var validateElement = (element, root, elementsToLink, linkElements, schemasToValidateAgainst) => {
   if (isIgnoredElement(element)) {
@@ -3076,6 +3146,9 @@ var validateElement = (element, root, elementsToLink, linkElements, schemasToVal
     if (schema.tag === FOOTNOTE_SCHEMA.tag) {
       errors.push(...validateFootnoteCue(element, linkElements));
     }
+    if (schema.code === HEADING_SCHEMA.code) {
+      errors.push(...validateHeadingHierarchy(element));
+    }
     if (isIgnoredValidation(schema.code)) {
       return errors;
     }

package/dist/index.mjs

@@ -1950,7 +1950,8 @@ var FOOTNOTE_SECTION_SCHEMA = createSchema({
 });
 
 // src/schema/elementSchemas/elements/heading.ts
-var HEADING_ROLES = ["H1", "H2", "H3", "H4", "H5", "H6", "vignette_group"];
+var HEADING_LEVEL = ["H1", "H2", "H3", "H4", "H5", "H6"];
+var HEADING_ROLES = [...HEADING_LEVEL, "vignette_group"];
 var HEADING_SCHEMA = createSchema({
   code: "heading",
   kind: "element",
@@ -2575,23 +2576,22 @@ var retrieveTextIgnoringNodesWithSelector = (element, selector = ".del") => {
   return clonedElement.textContent || "";
 };
 
+// src/validation/utils/isDeletedElement.ts
+var isDeletedElement = (element) => {
+  return !!element.closest(".del");
+};
+
 // src/validation/utils/getElementsSelector.ts
 var getElementsSelector = ({
   element,
   selector,
   filterDeletedNodes
 }) => {
-  const elements = element.querySelectorAll(selector);
+  const elements = Array.from(element.querySelectorAll(selector));
   if (filterDeletedNodes) {
-    return Array.from(elements).filter((element2) => {
-      const hasDeletedParent = element2.closest(".del") !== null;
-      if (hasDeletedParent) {
-        return false;
-      }
-      return true;
-    });
+    return elements.filter((element2) => !isDeletedElement(element2));
   }
-  return Array.from(elements);
+  return elements;
 };
 
 // src/validation/validateLinkend.ts
@@ -2976,6 +2976,76 @@ var validatePossibleWeblinks = (root) => {
   return errors;
 };
 
+// src/validation/utils/getParentElement.ts
+var getParentElement = ({
+  element,
+  schemaCode,
+  filterDeletedNodes
+}) => {
+  let current = element.parentElement;
+  while (current) {
+    const isValidParent = findSchemaByElement(current)?.code === schemaCode;
+    const isFilterDeleted = filterDeletedNodes && isDeletedElement(current);
+    if (isValidParent || isFilterDeleted) {
+      return current;
+    }
+    current = current.parentElement;
+  }
+  return void 0;
+};
+
+// src/validation/validateHeadingHierarchy.ts
+var getHierarchyLevel = (element) => {
+  const role = element.getAttribute("role");
+  if (!role) return void 0;
+  const validHeadingLevel = HEADING_LEVEL.indexOf(role) + 1;
+  if (!validHeadingLevel) return void 0;
+  return validHeadingLevel;
+};
+var validateHeadingHierarchy = (element) => {
+  const errors = [];
+  if (isDeletedElement(element)) {
+    return errors;
+  }
+  const level = getHierarchyLevel(element);
+  if (level === void 0) {
+    return errors;
+  }
+  const parentHeading = getParentElement({
+    element,
+    schemaCode: HEADING_SCHEMA.code,
+    filterDeletedNodes: true
+  });
+  if (!parentHeading) {
+    if (level !== 1) {
+      addValidationIssue(errors, {
+        store: getStore(element),
+        title: "Missing heading H1",
+        kind: "missing",
+        description: `H${level} is not under an H1. Please check the heading hierarchy.`,
+        level: "warning"
+      });
+    }
+    return errors;
+  }
+  const parentLevel = getHierarchyLevel(parentHeading);
+  if (parentLevel === void 0) {
+    return errors;
+  }
+  const expectedLevel = parentLevel + 1;
+  if (level === expectedLevel) {
+    return errors;
+  }
+  addValidationIssue(errors, {
+    store: getStore(element),
+    title: "Invalid heading hierarchy",
+    kind: "forbidden",
+    description: `H${level} cannot follow H${parentLevel} directly. Please check the heading hierarchy.`,
+    level: "warning"
+  });
+  return errors;
+};
+
 // src/validation/validateXml.ts
 var validateElement = (element, root, elementsToLink, linkElements, schemasToValidateAgainst) => {
   if (isIgnoredElement(element)) {
@@ -2996,6 +3066,9 @@ var validateElement = (element, root, elementsToLink, linkElements, schemasToVal
     if (schema.tag === FOOTNOTE_SCHEMA.tag) {
       errors.push(...validateFootnoteCue(element, linkElements));
     }
+    if (schema.code === HEADING_SCHEMA.code) {
+      errors.push(...validateHeadingHierarchy(element));
+    }
     if (isIgnoredValidation(schema.code)) {
       return errors;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pro-editor-schema",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "Pro Editor XML schemas",
   "main": "dist/index.js",
   "module": "dist/index.mjs",