pro-editor-schema 1.5.5-7 → 1.5.5-8

package/README.md

@@ -182,7 +182,7 @@ From `src/index.ts`, consumers can import:
 - **Schema helpers:** `findSchemaByCode`, `findSchemaByElement`, `findAttributeDefinitionByName`, `getAttributeName`, `isAttributeRestricted`, `isTrackChangesSchema`
 - **DOM helpers:** `createElement`, `closestElementBySchema`, `queryElementBySchema`, `queryAllElementsBySchema`, `getElementLinks`, `getStore`, `isDeletedElement`
 - **Ignored nodes:** `isIgnoredAttribute`, `isIgnoredElement`, `IGNORED_ATTRIBUTES`, `IGNORED_ELEMENT_SELECTORS`
-- **Validation:** `validateXml`
+- **Validation:** `validateXml`, `validateXmlAsync`
 - **Shared constants:** `ElementLabel`, global attribute constants, dependents forbidden elements
 
 ## Usage examples
@@ -256,6 +256,28 @@ It also runs per-element checks for:
 
 Schema-based attribute and child validation only runs for codes listed in `schemasToValidateAgainst`.
 
+### Validate a large document without freezing the page
+
+```ts
+import { validateXmlAsync } from "pro-editor-schema";
+
+const controller = new AbortController();
+const errors = await validateXmlAsync(
+  rootElement.cloneNode(true) as Element,
+  elementsToLink,
+  linkElements,
+  ["para", "heading"],
+  { signal: controller.signal },
+);
+```
+
+`validateXmlAsync` returns the same issues as `validateXml`, in the same order, but works in short slices and hands the main thread back between them (`scheduler.yield()` where available, otherwise `setTimeout`).
+
+- `signal` — aborting it rejects the promise with the signal's reason, for example when a newer edit makes the run outdated.
+- `timeBudgetMs` — how long to work before yielding. Defaults to 8 ms.
+
+Pass a copy of the document if it can change while validation runs.
+
 Listing `referenceBibliomixed` checks each bibliography entry against the schema of its reference type instead (see [Reference schemas](#reference-schemas)).
 
 ## How validation works

package/dist/index.d.mts

@@ -1002,7 +1002,7 @@ type ValidationError = {
 
 /**
  * Validates the XML document against the schema.
- 
+
  * @param xml - The XML document to validate.
  * @param elementsToLink - The elements IDs that are linked to.
  * @param linkElements - The elements IDs that are linked to.
@@ -1011,11 +1011,29 @@ type ValidationError = {
  * @returns The validation errors.
  */
 declare const validateXml: (xml: Element, elementsToLink: string[], linkElements: string[], schemasToValidateAgainst: SchemaCode[]) => ValidationError[];
+type ValidateXmlAsyncOptions = {
+    /** Rejects with the signal's reason once aborted. */
+    signal?: AbortSignal;
+    /** How long to work before handing the main thread back. Defaults to 8 ms. */
+    timeBudgetMs?: number;
+};
+/**
+ * Same result as `validateXml`, but works in short slices and hands the main
+ * thread back between them, so large documents do not freeze the page.
+ *
+ * Pass a copy of the document if it can change while validation runs.
+ */
+declare const validateXmlAsync: (xml: Element, elementsToLink: string[], linkElements: string[], schemasToValidateAgainst: SchemaCode[], { signal, timeBudgetMs }?: ValidateXmlAsyncOptions) => Promise<ValidationError[]>;
+
+type LinkIds = readonly string[] | ReadonlySet<string>;
 
-declare const findElementLinkedTo: (linkend: string, elementsToLink: string[]) => boolean;
+declare const findElementLinkedTo: (linkend: string, elementsToLink: LinkIds) => boolean;
 declare const LINK_TO_CROSS_CHECK: string[];
 declare const LINK_BLOCKER_ROLES: string[];
-declare const validateLinkend: (linkElement: Element, elementsToLink: string[]) => ValidationError[];
+declare const validateLinkend: (linkElement: Element, elementsToLink: LinkIds) => ValidationError[];
+
+/** Work split into steps: each `yield` is a point where a caller may pause. */
+type Steps<T> = Generator<void, T, void>;
 
 declare const POSSIBLE_WEBLINK_CLASS = "possible-weblink";
 declare const POSSIBLE_WEBLINK_EXCLUDE_SELECTORS: string[];
@@ -1025,6 +1043,7 @@ type PossibleWeblink = {
 };
 declare const getPossibleWeblinks: (root: Element) => Map<string, PossibleWeblink>;
 declare const markPossibleWeblinks: (editor: HTMLElement) => Map<string, PossibleWeblink>;
+declare function validatePossibleWeblinksSteps(root: Element): Steps<ValidationError[]>;
 declare const validatePossibleWeblinks: (root: Element) => ValidationError[];
 declare const clearWeblinkMatches: (editor: HTMLElement) => void;
 
@@ -1038,7 +1057,7 @@ declare const validateFootnoteNumber: (footnoteElement: Element) => ValidationEr
 declare const validateConsecutiveFootnotes: (root: Element | Document) => ValidationError[];
 declare const validateConsecutiveFootnoteCues: (root: Element | Document) => ValidationError[];
 
-declare const validateElementToLinkTo: (element: Element, linkElements: string[]) => ValidationError[];
+declare const validateElementToLinkTo: (element: Element, linkElements: LinkIds) => ValidationError[];
 
 declare const validateElementAgainstSchema: (element: Element, schema: Schema) => ValidationError[];
 declare const getEffectiveChildElements: (element: Element) => Element[];
@@ -1122,4 +1141,4 @@ declare const REFERENCE_PART_SELECTOR: string;
 declare const getReferenceParts: (reference: Element) => HTMLElement[];
 declare const getReferenceFieldElements: (reference: Element) => ReferenceFieldElement[];
 
-export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, type BibliomsetRelation, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, ElementLabel, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, LINKEND_ATTRIBUTE, LINK_BLOCKER_ROLES, LINK_TO_CROSS_CHECK, POSSIBLE_WEBLINK_CLASS, POSSIBLE_WEBLINK_EXCLUDE_SELECTORS, REFERENCE_FIELD_SCHEMAS, REFERENCE_PART_SELECTOR, REFERENCE_TYPE_SCHEMAS, RIGHT_INDENT_ATTRIBUTE, type ReferenceElementReplacement, type ReferenceFieldCode, type ReferenceFieldElement, type ReferenceFieldSchema, type ReferenceMarkupIssue, type ReferenceMarkupRule, type ReferenceStructureIssue, type ReferenceTypeCode, type ReferenceTypeSchema, type RequiredReferenceField, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaAttributes, type SchemaCode, type SchemaKind, type SchemasByCode, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, VALIDATION_IGNORED_ATTRIBUTE, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, XMLID_ATTRIBUTE, clearWeblinkMatches, closestElementBySchema, createElement, extractFootnoteNumber, findAttributeDefinitionByName, findElementLinkedTo, findReferenceFieldByElement, findReferenceTypeSchemaByElement, findSchemaByCode, findSchemaByElement, getAdjacentElement, getAttributeName, getEffectiveChildElements, getElementLinks, getPossibleWeblinks, getReferenceFieldElements, getReferenceParts, getReferenceStructureIssueElements, getStore, isAttributeRestricted, isDeletedElement, isIgnoredAttribute, isIgnoredElement, isTrackChangesSchema, markPossibleWeblinks, queryAllElementsBySchema, queryElementBySchema, validateAttributes, validateConsecutiveFootnoteCues, validateConsecutiveFootnotes, validateElementAgainstSchema, validateElementToLinkTo, validateFootnoteNumber, validateHierarchy, validateLinkend, validateOlink, validatePossibleWeblinks, validateReferenceStructure, validateXml };
+export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, type BibliomsetRelation, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, ElementLabel, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, LINKEND_ATTRIBUTE, LINK_BLOCKER_ROLES, LINK_TO_CROSS_CHECK, POSSIBLE_WEBLINK_CLASS, POSSIBLE_WEBLINK_EXCLUDE_SELECTORS, REFERENCE_FIELD_SCHEMAS, REFERENCE_PART_SELECTOR, REFERENCE_TYPE_SCHEMAS, RIGHT_INDENT_ATTRIBUTE, type ReferenceElementReplacement, type ReferenceFieldCode, type ReferenceFieldElement, type ReferenceFieldSchema, type ReferenceMarkupIssue, type ReferenceMarkupRule, type ReferenceStructureIssue, type ReferenceTypeCode, type ReferenceTypeSchema, type RequiredReferenceField, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaAttributes, type SchemaCode, type SchemaKind, type SchemasByCode, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, VALIDATION_IGNORED_ATTRIBUTE, type ValidateXmlAsyncOptions, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, XMLID_ATTRIBUTE, clearWeblinkMatches, closestElementBySchema, createElement, extractFootnoteNumber, findAttributeDefinitionByName, findElementLinkedTo, findReferenceFieldByElement, findReferenceTypeSchemaByElement, findSchemaByCode, findSchemaByElement, getAdjacentElement, getAttributeName, getEffectiveChildElements, getElementLinks, getPossibleWeblinks, getReferenceFieldElements, getReferenceParts, getReferenceStructureIssueElements, getStore, isAttributeRestricted, isDeletedElement, isIgnoredAttribute, isIgnoredElement, isTrackChangesSchema, markPossibleWeblinks, queryAllElementsBySchema, queryElementBySchema, validateAttributes, validateConsecutiveFootnoteCues, validateConsecutiveFootnotes, validateElementAgainstSchema, validateElementToLinkTo, validateFootnoteNumber, validateHierarchy, validateLinkend, validateOlink, validatePossibleWeblinks, validatePossibleWeblinksSteps, validateReferenceStructure, validateXml, validateXmlAsync };

package/dist/index.d.ts

@@ -1002,7 +1002,7 @@ type ValidationError = {
 
 /**
  * Validates the XML document against the schema.
- 
+
  * @param xml - The XML document to validate.
  * @param elementsToLink - The elements IDs that are linked to.
  * @param linkElements - The elements IDs that are linked to.
@@ -1011,11 +1011,29 @@ type ValidationError = {
  * @returns The validation errors.
  */
 declare const validateXml: (xml: Element, elementsToLink: string[], linkElements: string[], schemasToValidateAgainst: SchemaCode[]) => ValidationError[];
+type ValidateXmlAsyncOptions = {
+    /** Rejects with the signal's reason once aborted. */
+    signal?: AbortSignal;
+    /** How long to work before handing the main thread back. Defaults to 8 ms. */
+    timeBudgetMs?: number;
+};
+/**
+ * Same result as `validateXml`, but works in short slices and hands the main
+ * thread back between them, so large documents do not freeze the page.
+ *
+ * Pass a copy of the document if it can change while validation runs.
+ */
+declare const validateXmlAsync: (xml: Element, elementsToLink: string[], linkElements: string[], schemasToValidateAgainst: SchemaCode[], { signal, timeBudgetMs }?: ValidateXmlAsyncOptions) => Promise<ValidationError[]>;
+
+type LinkIds = readonly string[] | ReadonlySet<string>;
 
-declare const findElementLinkedTo: (linkend: string, elementsToLink: string[]) => boolean;
+declare const findElementLinkedTo: (linkend: string, elementsToLink: LinkIds) => boolean;
 declare const LINK_TO_CROSS_CHECK: string[];
 declare const LINK_BLOCKER_ROLES: string[];
-declare const validateLinkend: (linkElement: Element, elementsToLink: string[]) => ValidationError[];
+declare const validateLinkend: (linkElement: Element, elementsToLink: LinkIds) => ValidationError[];
+
+/** Work split into steps: each `yield` is a point where a caller may pause. */
+type Steps<T> = Generator<void, T, void>;
 
 declare const POSSIBLE_WEBLINK_CLASS = "possible-weblink";
 declare const POSSIBLE_WEBLINK_EXCLUDE_SELECTORS: string[];
@@ -1025,6 +1043,7 @@ type PossibleWeblink = {
 };
 declare const getPossibleWeblinks: (root: Element) => Map<string, PossibleWeblink>;
 declare const markPossibleWeblinks: (editor: HTMLElement) => Map<string, PossibleWeblink>;
+declare function validatePossibleWeblinksSteps(root: Element): Steps<ValidationError[]>;
 declare const validatePossibleWeblinks: (root: Element) => ValidationError[];
 declare const clearWeblinkMatches: (editor: HTMLElement) => void;
 
@@ -1038,7 +1057,7 @@ declare const validateFootnoteNumber: (footnoteElement: Element) => ValidationEr
 declare const validateConsecutiveFootnotes: (root: Element | Document) => ValidationError[];
 declare const validateConsecutiveFootnoteCues: (root: Element | Document) => ValidationError[];
 
-declare const validateElementToLinkTo: (element: Element, linkElements: string[]) => ValidationError[];
+declare const validateElementToLinkTo: (element: Element, linkElements: LinkIds) => ValidationError[];
 
 declare const validateElementAgainstSchema: (element: Element, schema: Schema) => ValidationError[];
 declare const getEffectiveChildElements: (element: Element) => Element[];
@@ -1122,4 +1141,4 @@ declare const REFERENCE_PART_SELECTOR: string;
 declare const getReferenceParts: (reference: Element) => HTMLElement[];
 declare const getReferenceFieldElements: (reference: Element) => ReferenceFieldElement[];
 
-export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, type BibliomsetRelation, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, ElementLabel, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, LINKEND_ATTRIBUTE, LINK_BLOCKER_ROLES, LINK_TO_CROSS_CHECK, POSSIBLE_WEBLINK_CLASS, POSSIBLE_WEBLINK_EXCLUDE_SELECTORS, REFERENCE_FIELD_SCHEMAS, REFERENCE_PART_SELECTOR, REFERENCE_TYPE_SCHEMAS, RIGHT_INDENT_ATTRIBUTE, type ReferenceElementReplacement, type ReferenceFieldCode, type ReferenceFieldElement, type ReferenceFieldSchema, type ReferenceMarkupIssue, type ReferenceMarkupRule, type ReferenceStructureIssue, type ReferenceTypeCode, type ReferenceTypeSchema, type RequiredReferenceField, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaAttributes, type SchemaCode, type SchemaKind, type SchemasByCode, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, VALIDATION_IGNORED_ATTRIBUTE, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, XMLID_ATTRIBUTE, clearWeblinkMatches, closestElementBySchema, createElement, extractFootnoteNumber, findAttributeDefinitionByName, findElementLinkedTo, findReferenceFieldByElement, findReferenceTypeSchemaByElement, findSchemaByCode, findSchemaByElement, getAdjacentElement, getAttributeName, getEffectiveChildElements, getElementLinks, getPossibleWeblinks, getReferenceFieldElements, getReferenceParts, getReferenceStructureIssueElements, getStore, isAttributeRestricted, isDeletedElement, isIgnoredAttribute, isIgnoredElement, isTrackChangesSchema, markPossibleWeblinks, queryAllElementsBySchema, queryElementBySchema, validateAttributes, validateConsecutiveFootnoteCues, validateConsecutiveFootnotes, validateElementAgainstSchema, validateElementToLinkTo, validateFootnoteNumber, validateHierarchy, validateLinkend, validateOlink, validatePossibleWeblinks, validateReferenceStructure, validateXml };
+export { ALIGNMENT_ATTRIBUTE, ATOM_SCHEMAS, type AllowedChildren, type AtomSchemaCode, type AttributeDefinition, type BibliomsetRelation, DEPENDENT_FORBIDDEN_ELEMENTS, ELEMENT_SCHEMAS, ELE_ID_ATTRIBUTE, ElementLabel, type ElementSchemaCode, FIGURE_PLACEMENT_ATTRIBUTE, type FreeAttribute, ID_ATTRS, IGNORED_ATTRIBUTES, IGNORED_ATTRIBUTES_STARTS_WITH, IGNORED_ELEMENT_SELECTORS, INDENT_TYPE_ATTRIBUTE, INLINE_ELEMENT_SCHEMAS, type InlineSchemaCode, LAYOUT_ATTRIBUTES, LAYOUT_CELL_WIDTH_ATTRIBUTE, LAYOUT_TABLE_ORIENTATION_ATTRIBUTE, LAYOUT_TABLE_PLACEMENT_ATTRIBUTE, LAYOUT_USER_ATTRIBUTE, LEFT_INDENT_ATTRIBUTE, LINKEND_ATTRIBUTE, LINK_BLOCKER_ROLES, LINK_TO_CROSS_CHECK, POSSIBLE_WEBLINK_CLASS, POSSIBLE_WEBLINK_EXCLUDE_SELECTORS, REFERENCE_FIELD_SCHEMAS, REFERENCE_PART_SELECTOR, REFERENCE_TYPE_SCHEMAS, RIGHT_INDENT_ATTRIBUTE, type ReferenceElementReplacement, type ReferenceFieldCode, type ReferenceFieldElement, type ReferenceFieldSchema, type ReferenceMarkupIssue, type ReferenceMarkupRule, type ReferenceStructureIssue, type ReferenceTypeCode, type ReferenceTypeSchema, type RequiredReferenceField, type RestrictedAttribute, SCHEMAS, SPACE_ABOVE_ATTRIBUTE, SPACE_BELOW_ATTRIBUTE, SPECIAL_INDENT_ATTRIBUTE, STORE_ATTRIBUTE, STYLE_NAME_ATTRIBUTE, type Schema, type SchemaAttributes, type SchemaCode, type SchemaKind, type SchemasByCode, TRACK_CHANGES_ATTRS, TRACK_CHANGES_ATTR_DATA_DATE, TRACK_CHANGES_ATTR_DATA_TIME, TRACK_CHANGES_ATTR_DATA_USERID, TRACK_CHANGES_ATTR_DATA_USERNAME, VALIDATION_IGNORED_ATTRIBUTE, type ValidateXmlAsyncOptions, type ValidationError, type ValidationErrorKind, type ValidationErrorLevel, XMLID_ATTRIBUTE, clearWeblinkMatches, closestElementBySchema, createElement, extractFootnoteNumber, findAttributeDefinitionByName, findElementLinkedTo, findReferenceFieldByElement, findReferenceTypeSchemaByElement, findSchemaByCode, findSchemaByElement, getAdjacentElement, getAttributeName, getEffectiveChildElements, getElementLinks, getPossibleWeblinks, getReferenceFieldElements, getReferenceParts, getReferenceStructureIssueElements, getStore, isAttributeRestricted, isDeletedElement, isIgnoredAttribute, isIgnoredElement, isTrackChangesSchema, markPossibleWeblinks, queryAllElementsBySchema, queryElementBySchema, validateAttributes, validateConsecutiveFootnoteCues, validateConsecutiveFootnotes, validateElementAgainstSchema, validateElementToLinkTo, validateFootnoteNumber, validateHierarchy, validateLinkend, validateOlink, validatePossibleWeblinks, validatePossibleWeblinksSteps, validateReferenceStructure, validateXml, validateXmlAsync };

package/dist/index.js

@@ -108,8 +108,10 @@ __export(index_exports, {
   validateLinkend: () => validateLinkend,
   validateOlink: () => validateOlink,
   validatePossibleWeblinks: () => validatePossibleWeblinks,
+  validatePossibleWeblinksSteps: () => validatePossibleWeblinksSteps,
   validateReferenceStructure: () => validateReferenceStructure,
-  validateXml: () => validateXml
+  validateXml: () => validateXml,
+  validateXmlAsync: () => validateXmlAsync
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -2845,12 +2847,19 @@ var findAttributeDefinitionByName = (definitions, name) => {
 var findSchemaByCode = (code) => SCHEMAS[code];
 
 // src/schema/helpers/findSchemaByElement.ts
-var findSchemaByElement = (element) => {
-  const schema = Object.values(SCHEMAS).find(
-    (schema2) => matchesSchemaTag(element, schema2.tag) && (!schema2.matchesElement || schema2.matchesElement(element))
-  );
-  return schema;
+var schemasByTag;
+var getSchemasByTag = () => {
+  if (schemasByTag) return schemasByTag;
+  schemasByTag = /* @__PURE__ */ new Map();
+  for (const schema of Object.values(SCHEMAS)) {
+    const tag = schema.tag.toUpperCase();
+    const schemas = schemasByTag.get(tag);
+    if (schemas) schemas.push(schema);
+    else schemasByTag.set(tag, [schema]);
+  }
+  return schemasByTag;
 };
+var findSchemaByElement = (element) => getSchemasByTag().get(element.tagName.toUpperCase())?.find((schema) => !schema.matchesElement || schema.matchesElement(element));
 
 // src/schema/helpers/isAttributeRestricted.ts
 var isAttributeRestricted = (attr) => typeof attr !== "string";
@@ -3394,7 +3403,8 @@ var IGNORED_ELEMENT_SELECTORS = [
   "span.ref-drag",
   "span#dummySpan"
 ];
-var isIgnoredElement = (element) => IGNORED_ELEMENT_SELECTORS.some((selector) => element.matches(selector));
+var IGNORED_ELEMENT_SELECTOR = IGNORED_ELEMENT_SELECTORS.join(", ");
+var isIgnoredElement = (element) => element.tagName.toUpperCase() === "SPAN" && element.matches(IGNORED_ELEMENT_SELECTOR);
 
 // src/validation/helpers/isIgnoredValidation.ts
 var IGNORED_VALIDATION_ELEMENT_SELECTORS = [
@@ -3553,10 +3563,11 @@ var validateConsecutiveFootnoteCues = (root) => {
   return errors;
 };
 
+// src/validation/helpers/hasLinkId.ts
+var hasLinkId = (ids, id) => "has" in ids ? ids.has(id) : ids.includes(id);
+
 // src/validation/validateLinkend.ts
-var findElementLinkedTo = (linkend, elementsToLink) => {
-  return elementsToLink.includes(linkend);
-};
+var findElementLinkedTo = (linkend, elementsToLink) => hasLinkId(elementsToLink, linkend);
 var LINK_TO_CROSS_CHECK = [
   TABLE_LINK_ROLE,
   FIGURE_LINK_ROLE,
@@ -3777,9 +3788,7 @@ var getExtraInstruction = (schema, childSchema) => {
 };
 
 // src/validation/validateElementToLinkTo.ts
-var findElementLinkedTo2 = (xmlid, linkElements) => {
-  return linkElements.includes(xmlid);
-};
+var findElementLinkedTo2 = (xmlid, linkElements) => hasLinkId(linkElements, xmlid);
 var isFootnote = (element) => {
   return matchesSchemaTag(element, FOOTNOTE_SCHEMA.tag);
 };
@@ -3849,6 +3858,16 @@ var validateElementToLinkTo = (element, linkElements) => {
 
 // src/validation/validateWeblink.ts
 var import_mark2 = __toESM(require("mark.js"));
+
+// src/validation/helpers/steps.ts
+var runSteps = (steps) => {
+  for (; ; ) {
+    const step = steps.next();
+    if (step.done) return step.value;
+  }
+};
+
+// src/validation/validateWeblink.ts
 var EDGE_PUNCTUATION = `:;.,\\-\u2013\u2014\u2012_(){}[\\]!'"+=\xAB\xBB\u2039\u203A\u201C\u201D\u2018\u2019<>`;
 var WEB_URI_PATTERN = `(?:(?:https?):\\/\\/|www\\.)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,}(?::\\d{1,5})?(?:\\/(?:[^\\s]*[^\\s${EDGE_PUNCTUATION}])?)?`;
 var WEB_URI_IN_TEXT_REGEX = new RegExp(WEB_URI_PATTERN, "gi");
@@ -3929,11 +3948,62 @@ var markPossibleWeblinks = (editor) => {
   });
   return possibleWeblinks;
 };
-var validatePossibleWeblinks = (root) => {
+var TEXT_NODES_PER_STEP = 256;
+var MARK_EXCLUDED_PARENT_SELECTOR = [
+  ...POSSIBLE_WEBLINK_EXCLUDE_SELECTORS,
+  "script",
+  "style",
+  "title",
+  "head",
+  "html"
+].join(", ");
+var createWeblinkMatchElement = (ownerDocument, text, storeId) => {
+  const element = ownerDocument.createElement("mark");
+  element.setAttribute("data-markjs", "true");
+  element.setAttribute("class", POSSIBLE_WEBLINK_CLASS);
+  element.setAttribute(STORE_ATTRIBUTE, storeId);
+  element.textContent = text;
+  return element;
+};
+function* findPossibleWeblinks(root) {
+  const possibleWeblinks = /* @__PURE__ */ new Map();
+  const ownerDocument = root.ownerDocument;
+  const walker = ownerDocument.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+  const regex = new RegExp(WEB_URI_PATTERN, "gi");
+  let nodesSinceStep = 0;
+  for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+    if (++nodesSinceStep === TEXT_NODES_PER_STEP) {
+      nodesSinceStep = 0;
+      yield;
+    }
+    const text = node.textContent ?? "";
+    if (!text) continue;
+    const parent = node.parentNode;
+    if (parent instanceof Element && parent.matches(MARK_EXCLUDED_PARENT_SELECTOR)) {
+      continue;
+    }
+    regex.lastIndex = 0;
+    for (let match = regex.exec(text); match; match = regex.exec(text)) {
+      const storeId = getWeblinkMatchId(possibleWeblinks.size);
+      possibleWeblinks.set(storeId, {
+        weblink: match[0],
+        elements: [createWeblinkMatchElement(ownerDocument, match[0], storeId)]
+      });
+    }
+  }
+  return possibleWeblinks;
+}
+var hasWeblinkMatches = (root) => root.getElementsByClassName(POSSIBLE_WEBLINK_CLASS).length > 0;
+function* validatePossibleWeblinksSteps(root) {
   const issues = [];
-  const cloneRoot = root.cloneNode(true);
-  clearWeblinkMatches(cloneRoot);
-  const possibleWeblinks = markPossibleWeblinks(cloneRoot);
+  let possibleWeblinks;
+  if (hasWeblinkMatches(root)) {
+    const cloneRoot = root.cloneNode(true);
+    clearWeblinkMatches(cloneRoot);
+    possibleWeblinks = markPossibleWeblinks(cloneRoot);
+  } else {
+    possibleWeblinks = yield* findPossibleWeblinks(root);
+  }
   for (const [storeId, { elements }] of Array.from(possibleWeblinks)) {
     issues.push(
       createValidationIssue(null, {
@@ -3947,7 +4017,8 @@ var validatePossibleWeblinks = (root) => {
     );
   }
   return issues;
-};
+}
+var validatePossibleWeblinks = (root) => runSteps(validatePossibleWeblinksSteps(root));
 var clearWeblinkMatches = (editor) => {
   const instance = new import_mark2.default(editor);
   instance.unmark({
@@ -4404,66 +4475,106 @@ var validateReference = (reference) => {
 };
 
 // src/validation/validateXml.ts
-var validateElement = (element, root, elementsToLink, linkElements, schemasToValidateAgainst) => {
+var ELEMENTS_PER_STEP = 64;
+var DEFAULT_TIME_BUDGET_MS = 8;
+var validateOwnElement = (element, {
+  elementsToLink,
+  linkElements,
+  schemasToValidateAgainst,
+  errors
+}) => {
   if (isIgnoredElement(element)) {
-    return [];
+    return false;
   }
-  const errors = [];
   const schema = findSchemaByElement(element);
-  if (schema) {
-    if (schemasToValidateAgainst.includes(schema.code)) {
-      errors.push(
-        ...schema.code === BIBLIOMIXED_SCHEMA.code ? validateReference(element) : validateElementAgainstSchema(element, schema)
-      );
-    }
-    if (schema.tag === FOOTNOTE_SCHEMA.tag) {
-      errors.push(...validateFootnoteNumber(element));
-    }
-    if (schema.code === HEADING_SCHEMA.code) {
-      errors.push(...validateHierarchy(element, "heading"));
-    }
-    if (schema.code === BOX_SCHEMA.code) {
-      errors.push(...validateHierarchy(element, "box"));
-    }
-    if (schema.code === OLINK_SCHEMA.code) {
-      errors.push(...validateOlink(element));
-    }
-    errors.push(...validateLinkend(element, elementsToLink));
-    errors.push(...validateElementToLinkTo(element, linkElements));
-    if (isIgnoredValidation(schema.code)) {
-      return errors;
-    }
+  if (!schema) {
+    return true;
   }
-  for (const child of Array.from(element.children)) {
+  if (schemasToValidateAgainst.includes(schema.code)) {
     errors.push(
-      ...validateElement(
-        child,
-        root,
-        elementsToLink,
-        linkElements,
-        schemasToValidateAgainst
-      )
+      ...schema.code === BIBLIOMIXED_SCHEMA.code ? validateReference(element) : validateElementAgainstSchema(element, schema)
     );
   }
-  return errors;
+  if (schema.tag === FOOTNOTE_SCHEMA.tag) {
+    errors.push(...validateFootnoteNumber(element));
+  }
+  if (schema.code === HEADING_SCHEMA.code) {
+    errors.push(...validateHierarchy(element, "heading"));
+  }
+  if (schema.code === BOX_SCHEMA.code) {
+    errors.push(...validateHierarchy(element, "box"));
+  }
+  if (schema.code === OLINK_SCHEMA.code) {
+    errors.push(...validateOlink(element));
+  }
+  errors.push(...validateLinkend(element, elementsToLink));
+  errors.push(...validateElementToLinkTo(element, linkElements));
+  return !isIgnoredValidation(schema.code);
 };
-var validateXml = (xml, elementsToLink, linkElements, schemasToValidateAgainst) => {
+function* validateElements(xml, context) {
+  const pending = Array.from(xml.children).reverse();
+  let elementsSinceStep = 0;
+  for (let element = pending.pop(); element; element = pending.pop()) {
+    if (validateOwnElement(element, context)) {
+      const { children } = element;
+      for (let index = children.length - 1; index >= 0; index -= 1) {
+        pending.push(children[index]);
+      }
+    }
+    if (++elementsSinceStep === ELEMENTS_PER_STEP) {
+      elementsSinceStep = 0;
+      yield;
+    }
+  }
+}
+function* validateXmlSteps(xml, elementsToLink, linkElements, schemasToValidateAgainst) {
   const errors = [];
   errors.push(...validateConsecutiveFootnotes(xml));
   errors.push(...validateConsecutiveFootnoteCues(xml));
-  errors.push(...validatePossibleWeblinks(xml));
-  for (const child of Array.from(xml.children)) {
-    errors.push(
-      ...validateElement(
-        child,
-        xml,
-        elementsToLink,
-        linkElements,
-        schemasToValidateAgainst
-      )
-    );
-  }
+  yield;
+  errors.push(...yield* validatePossibleWeblinksSteps(xml));
+  yield* validateElements(xml, {
+    elementsToLink: new Set(elementsToLink),
+    linkElements: new Set(linkElements),
+    schemasToValidateAgainst,
+    errors
+  });
   return errors;
+}
+var validateXml = (xml, elementsToLink, linkElements, schemasToValidateAgainst) => runSteps(
+  validateXmlSteps(
+    xml,
+    elementsToLink,
+    linkElements,
+    schemasToValidateAgainst
+  )
+);
+var yieldToMainThread = () => {
+  const scheduler = globalThis.scheduler;
+  if (scheduler?.yield) return scheduler.yield();
+  return new Promise((resolve) => setTimeout(resolve, 0));
+};
+var throwIfAborted = (signal) => {
+  if (!signal?.aborted) return;
+  throw signal.reason ?? new DOMException("Aborted", "AbortError");
+};
+var validateXmlAsync = async (xml, elementsToLink, linkElements, schemasToValidateAgainst, { signal, timeBudgetMs = DEFAULT_TIME_BUDGET_MS } = {}) => {
+  const steps = validateXmlSteps(
+    xml,
+    elementsToLink,
+    linkElements,
+    schemasToValidateAgainst
+  );
+  let sliceStart = performance.now();
+  for (; ; ) {
+    throwIfAborted(signal);
+    const step = steps.next();
+    if (step.done) return step.value;
+    if (performance.now() - sliceStart >= timeBudgetMs) {
+      await yieldToMainThread();
+      sliceStart = performance.now();
+    }
+  }
 };
 
 // src/helpers/getElementLinks.ts
@@ -4623,6 +4734,8 @@ var getAdjacentElement = ({
   validateLinkend,
   validateOlink,
   validatePossibleWeblinks,
+  validatePossibleWeblinksSteps,
   validateReferenceStructure,
-  validateXml
+  validateXml,
+  validateXmlAsync
 });

package/dist/index.mjs

@@ -2730,12 +2730,19 @@ var findAttributeDefinitionByName = (definitions, name) => {
 var findSchemaByCode = (code) => SCHEMAS[code];
 
 // src/schema/helpers/findSchemaByElement.ts
-var findSchemaByElement = (element) => {
-  const schema = Object.values(SCHEMAS).find(
-    (schema2) => matchesSchemaTag(element, schema2.tag) && (!schema2.matchesElement || schema2.matchesElement(element))
-  );
-  return schema;
+var schemasByTag;
+var getSchemasByTag = () => {
+  if (schemasByTag) return schemasByTag;
+  schemasByTag = /* @__PURE__ */ new Map();
+  for (const schema of Object.values(SCHEMAS)) {
+    const tag = schema.tag.toUpperCase();
+    const schemas = schemasByTag.get(tag);
+    if (schemas) schemas.push(schema);
+    else schemasByTag.set(tag, [schema]);
+  }
+  return schemasByTag;
 };
+var findSchemaByElement = (element) => getSchemasByTag().get(element.tagName.toUpperCase())?.find((schema) => !schema.matchesElement || schema.matchesElement(element));
 
 // src/schema/helpers/isAttributeRestricted.ts
 var isAttributeRestricted = (attr) => typeof attr !== "string";
@@ -3279,7 +3286,8 @@ var IGNORED_ELEMENT_SELECTORS = [
   "span.ref-drag",
   "span#dummySpan"
 ];
-var isIgnoredElement = (element) => IGNORED_ELEMENT_SELECTORS.some((selector) => element.matches(selector));
+var IGNORED_ELEMENT_SELECTOR = IGNORED_ELEMENT_SELECTORS.join(", ");
+var isIgnoredElement = (element) => element.tagName.toUpperCase() === "SPAN" && element.matches(IGNORED_ELEMENT_SELECTOR);
 
 // src/validation/helpers/isIgnoredValidation.ts
 var IGNORED_VALIDATION_ELEMENT_SELECTORS = [
@@ -3438,10 +3446,11 @@ var validateConsecutiveFootnoteCues = (root) => {
   return errors;
 };
 
+// src/validation/helpers/hasLinkId.ts
+var hasLinkId = (ids, id) => "has" in ids ? ids.has(id) : ids.includes(id);
+
 // src/validation/validateLinkend.ts
-var findElementLinkedTo = (linkend, elementsToLink) => {
-  return elementsToLink.includes(linkend);
-};
+var findElementLinkedTo = (linkend, elementsToLink) => hasLinkId(elementsToLink, linkend);
 var LINK_TO_CROSS_CHECK = [
   TABLE_LINK_ROLE,
   FIGURE_LINK_ROLE,
@@ -3662,9 +3671,7 @@ var getExtraInstruction = (schema, childSchema) => {
 };
 
 // src/validation/validateElementToLinkTo.ts
-var findElementLinkedTo2 = (xmlid, linkElements) => {
-  return linkElements.includes(xmlid);
-};
+var findElementLinkedTo2 = (xmlid, linkElements) => hasLinkId(linkElements, xmlid);
 var isFootnote = (element) => {
   return matchesSchemaTag(element, FOOTNOTE_SCHEMA.tag);
 };
@@ -3734,6 +3741,16 @@ var validateElementToLinkTo = (element, linkElements) => {
 
 // src/validation/validateWeblink.ts
 import Mark from "mark.js";
+
+// src/validation/helpers/steps.ts
+var runSteps = (steps) => {
+  for (; ; ) {
+    const step = steps.next();
+    if (step.done) return step.value;
+  }
+};
+
+// src/validation/validateWeblink.ts
 var EDGE_PUNCTUATION = `:;.,\\-\u2013\u2014\u2012_(){}[\\]!'"+=\xAB\xBB\u2039\u203A\u201C\u201D\u2018\u2019<>`;
 var WEB_URI_PATTERN = `(?:(?:https?):\\/\\/|www\\.)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,}(?::\\d{1,5})?(?:\\/(?:[^\\s]*[^\\s${EDGE_PUNCTUATION}])?)?`;
 var WEB_URI_IN_TEXT_REGEX = new RegExp(WEB_URI_PATTERN, "gi");
@@ -3814,11 +3831,62 @@ var markPossibleWeblinks = (editor) => {
   });
   return possibleWeblinks;
 };
-var validatePossibleWeblinks = (root) => {
+var TEXT_NODES_PER_STEP = 256;
+var MARK_EXCLUDED_PARENT_SELECTOR = [
+  ...POSSIBLE_WEBLINK_EXCLUDE_SELECTORS,
+  "script",
+  "style",
+  "title",
+  "head",
+  "html"
+].join(", ");
+var createWeblinkMatchElement = (ownerDocument, text, storeId) => {
+  const element = ownerDocument.createElement("mark");
+  element.setAttribute("data-markjs", "true");
+  element.setAttribute("class", POSSIBLE_WEBLINK_CLASS);
+  element.setAttribute(STORE_ATTRIBUTE, storeId);
+  element.textContent = text;
+  return element;
+};
+function* findPossibleWeblinks(root) {
+  const possibleWeblinks = /* @__PURE__ */ new Map();
+  const ownerDocument = root.ownerDocument;
+  const walker = ownerDocument.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+  const regex = new RegExp(WEB_URI_PATTERN, "gi");
+  let nodesSinceStep = 0;
+  for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+    if (++nodesSinceStep === TEXT_NODES_PER_STEP) {
+      nodesSinceStep = 0;
+      yield;
+    }
+    const text = node.textContent ?? "";
+    if (!text) continue;
+    const parent = node.parentNode;
+    if (parent instanceof Element && parent.matches(MARK_EXCLUDED_PARENT_SELECTOR)) {
+      continue;
+    }
+    regex.lastIndex = 0;
+    for (let match = regex.exec(text); match; match = regex.exec(text)) {
+      const storeId = getWeblinkMatchId(possibleWeblinks.size);
+      possibleWeblinks.set(storeId, {
+        weblink: match[0],
+        elements: [createWeblinkMatchElement(ownerDocument, match[0], storeId)]
+      });
+    }
+  }
+  return possibleWeblinks;
+}
+var hasWeblinkMatches = (root) => root.getElementsByClassName(POSSIBLE_WEBLINK_CLASS).length > 0;
+function* validatePossibleWeblinksSteps(root) {
   const issues = [];
-  const cloneRoot = root.cloneNode(true);
-  clearWeblinkMatches(cloneRoot);
-  const possibleWeblinks = markPossibleWeblinks(cloneRoot);
+  let possibleWeblinks;
+  if (hasWeblinkMatches(root)) {
+    const cloneRoot = root.cloneNode(true);
+    clearWeblinkMatches(cloneRoot);
+    possibleWeblinks = markPossibleWeblinks(cloneRoot);
+  } else {
+    possibleWeblinks = yield* findPossibleWeblinks(root);
+  }
   for (const [storeId, { elements }] of Array.from(possibleWeblinks)) {
     issues.push(
       createValidationIssue(null, {
@@ -3832,7 +3900,8 @@ var validatePossibleWeblinks = (root) => {
     );
   }
   return issues;
-};
+}
+var validatePossibleWeblinks = (root) => runSteps(validatePossibleWeblinksSteps(root));
 var clearWeblinkMatches = (editor) => {
   const instance = new Mark(editor);
   instance.unmark({
@@ -4289,66 +4358,106 @@ var validateReference = (reference) => {
 };
 
 // src/validation/validateXml.ts
-var validateElement = (element, root, elementsToLink, linkElements, schemasToValidateAgainst) => {
+var ELEMENTS_PER_STEP = 64;
+var DEFAULT_TIME_BUDGET_MS = 8;
+var validateOwnElement = (element, {
+  elementsToLink,
+  linkElements,
+  schemasToValidateAgainst,
+  errors
+}) => {
   if (isIgnoredElement(element)) {
-    return [];
+    return false;
   }
-  const errors = [];
   const schema = findSchemaByElement(element);
-  if (schema) {
-    if (schemasToValidateAgainst.includes(schema.code)) {
-      errors.push(
-        ...schema.code === BIBLIOMIXED_SCHEMA.code ? validateReference(element) : validateElementAgainstSchema(element, schema)
-      );
-    }
-    if (schema.tag === FOOTNOTE_SCHEMA.tag) {
-      errors.push(...validateFootnoteNumber(element));
-    }
-    if (schema.code === HEADING_SCHEMA.code) {
-      errors.push(...validateHierarchy(element, "heading"));
-    }
-    if (schema.code === BOX_SCHEMA.code) {
-      errors.push(...validateHierarchy(element, "box"));
-    }
-    if (schema.code === OLINK_SCHEMA.code) {
-      errors.push(...validateOlink(element));
-    }
-    errors.push(...validateLinkend(element, elementsToLink));
-    errors.push(...validateElementToLinkTo(element, linkElements));
-    if (isIgnoredValidation(schema.code)) {
-      return errors;
-    }
+  if (!schema) {
+    return true;
   }
-  for (const child of Array.from(element.children)) {
+  if (schemasToValidateAgainst.includes(schema.code)) {
     errors.push(
-      ...validateElement(
-        child,
-        root,
-        elementsToLink,
-        linkElements,
-        schemasToValidateAgainst
-      )
+      ...schema.code === BIBLIOMIXED_SCHEMA.code ? validateReference(element) : validateElementAgainstSchema(element, schema)
     );
   }
-  return errors;
+  if (schema.tag === FOOTNOTE_SCHEMA.tag) {
+    errors.push(...validateFootnoteNumber(element));
+  }
+  if (schema.code === HEADING_SCHEMA.code) {
+    errors.push(...validateHierarchy(element, "heading"));
+  }
+  if (schema.code === BOX_SCHEMA.code) {
+    errors.push(...validateHierarchy(element, "box"));
+  }
+  if (schema.code === OLINK_SCHEMA.code) {
+    errors.push(...validateOlink(element));
+  }
+  errors.push(...validateLinkend(element, elementsToLink));
+  errors.push(...validateElementToLinkTo(element, linkElements));
+  return !isIgnoredValidation(schema.code);
 };
-var validateXml = (xml, elementsToLink, linkElements, schemasToValidateAgainst) => {
+function* validateElements(xml, context) {
+  const pending = Array.from(xml.children).reverse();
+  let elementsSinceStep = 0;
+  for (let element = pending.pop(); element; element = pending.pop()) {
+    if (validateOwnElement(element, context)) {
+      const { children } = element;
+      for (let index = children.length - 1; index >= 0; index -= 1) {
+        pending.push(children[index]);
+      }
+    }
+    if (++elementsSinceStep === ELEMENTS_PER_STEP) {
+      elementsSinceStep = 0;
+      yield;
+    }
+  }
+}
+function* validateXmlSteps(xml, elementsToLink, linkElements, schemasToValidateAgainst) {
   const errors = [];
   errors.push(...validateConsecutiveFootnotes(xml));
   errors.push(...validateConsecutiveFootnoteCues(xml));
-  errors.push(...validatePossibleWeblinks(xml));
-  for (const child of Array.from(xml.children)) {
-    errors.push(
-      ...validateElement(
-        child,
-        xml,
-        elementsToLink,
-        linkElements,
-        schemasToValidateAgainst
-      )
-    );
-  }
+  yield;
+  errors.push(...yield* validatePossibleWeblinksSteps(xml));
+  yield* validateElements(xml, {
+    elementsToLink: new Set(elementsToLink),
+    linkElements: new Set(linkElements),
+    schemasToValidateAgainst,
+    errors
+  });
   return errors;
+}
+var validateXml = (xml, elementsToLink, linkElements, schemasToValidateAgainst) => runSteps(
+  validateXmlSteps(
+    xml,
+    elementsToLink,
+    linkElements,
+    schemasToValidateAgainst
+  )
+);
+var yieldToMainThread = () => {
+  const scheduler = globalThis.scheduler;
+  if (scheduler?.yield) return scheduler.yield();
+  return new Promise((resolve) => setTimeout(resolve, 0));
+};
+var throwIfAborted = (signal) => {
+  if (!signal?.aborted) return;
+  throw signal.reason ?? new DOMException("Aborted", "AbortError");
+};
+var validateXmlAsync = async (xml, elementsToLink, linkElements, schemasToValidateAgainst, { signal, timeBudgetMs = DEFAULT_TIME_BUDGET_MS } = {}) => {
+  const steps = validateXmlSteps(
+    xml,
+    elementsToLink,
+    linkElements,
+    schemasToValidateAgainst
+  );
+  let sliceStart = performance.now();
+  for (; ; ) {
+    throwIfAborted(signal);
+    const step = steps.next();
+    if (step.done) return step.value;
+    if (performance.now() - sliceStart >= timeBudgetMs) {
+      await yieldToMainThread();
+      sliceStart = performance.now();
+    }
+  }
 };
 
 // src/helpers/getElementLinks.ts
@@ -4507,6 +4616,8 @@ export {
   validateLinkend,
   validateOlink,
   validatePossibleWeblinks,
+  validatePossibleWeblinksSteps,
   validateReferenceStructure,
-  validateXml
+  validateXml,
+  validateXmlAsync
 };

package/package.json

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