@miy2/xml-api 0.9.0

package/dist/cst/xml-cst.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CST = void 0;
+/**
+ * Represents a node in the Concrete Syntax Tree (Parse Tree).
+ * Each node corresponds to a match of a grammatical structure or rule.
+ */
+class CST {
+    constructor(
+    /**
+     * The type of the grammatical structure matched.
+     * Common values include "literal", "regex", "sequence", "repeat".
+     * This describes the structural nature of the match, not the grammar rule name.
+     */
+    type, 
+    /**
+     * The name of the grammar rule corresponding to this node (e.g., "element", "attribute").
+     * Defined only if this node represents a named rule reference; otherwise undefined.
+     */
+    name, 
+    /**
+     * The 0-based starting index of this node in the entire input string (inclusive).
+     */
+    start, 
+    /**
+     * The 0-based ending index of this node in the entire input string (exclusive).
+     * The length of the match is (end - start).
+     */
+    end, 
+    /**
+     * Child nodes contained within this structure.
+     * Empty for leaf nodes like literals or regex matches.
+     */
+    children = [], 
+    /**
+     * Indicates whether the node satisfies additional validation logic beyond basic parsing.
+     * If false, the node was parsed successfully according to the grammar structure
+     * but failed a semantic or contextual validation check.
+     */
+    wellFormed = true) {
+        this.type = type;
+        this.name = name;
+        this.start = start;
+        this.end = end;
+        this.children = children;
+        this.wellFormed = wellFormed;
+        /**
+         * Reference to the parent node in the syntax tree.
+         * Null if this is the root node.
+         */
+        this.parent = null;
+        for (const child of children) {
+            child.parent = this;
+        }
+    }
+    /**
+     * Retrieves the substring matching this node from the entire original input string.
+     */
+    getText(input) {
+        return input.slice(this.start, this.end);
+    }
+    /**
+     * Shifts the start and end positions of this node and its children.
+     * @param pos The position where the change occurred.
+     * @param delta The change in length.
+     */
+    shift(pos, delta) {
+        if (delta > 0) {
+            if (this.start >= pos) {
+                this.start += delta;
+            }
+            if (this.end > pos) {
+                this.end += delta;
+            }
+        }
+        else {
+            // For deletion, delta is negative.
+            // The deletion range in original coordinates is [pos, pos - delta).
+            const deleteEnd = pos - delta;
+            if (this.start >= deleteEnd) {
+                // Node started after the deletion; shift it back.
+                this.start += delta;
+            }
+            else if (this.start > pos) {
+                // Node started inside the deletion region.
+                // It now starts at the deletion point.
+                this.start = pos;
+            }
+            if (this.end >= deleteEnd) {
+                // Node ended after the deletion; shift it back.
+                this.end += delta;
+            }
+            else if (this.end > pos) {
+                // Node ended inside the deletion region.
+                // It now ends at the deletion point.
+                this.end = pos;
+            }
+        }
+        for (const child of this.children) {
+            child.shift(pos, delta);
+        }
+    }
+    /**
+     * Unwraps single-child Reference nodes to find the underlying structural node.
+     */
+    unwrap() {
+        let current = this;
+        while (current.children.length === 1 &&
+            current.children[0].start === current.start &&
+            current.children[0].end === current.end) {
+            current = current.children[0];
+        }
+        return current;
+    }
+}
+exports.CST = CST;

package/dist/cst/xml-grammar.d.ts

@@ -0,0 +1,45 @@
+import { GrammarBuilder } from "./grammar";
+/**
+ * Unimplemented Well-formedness Constraints (WFC)
+ *
+ * The following constraints are currently not enforced by this parser.
+ * Implementation would require an Entity Manager, DTD Processor, and extended Context.
+ *
+ * - [WFC: PEs in Internal Subset]
+ *   "In the internal DTD subset, parameter-entity references MUST NOT occur within markup declarations..."
+ *   https://www.w3.org/TR/xml/#wfc-PEinInternalSubset
+ *
+ * - [WFC: External Subset]
+ *   "The external subset, if any, MUST match the production for extSubset."
+ *   https://www.w3.org/TR/xml/#ExtSubset
+ *
+ * - [WFC: PE Between Declarations]
+ *   "The replacement text of a parameter entity reference in a DeclSep MUST match the production extSubsetDecl."
+ *   https://www.w3.org/TR/xml/#PE-between-Decls
+ *
+ * - [WFC: No External Entity References]
+ *   "Attribute values MUST NOT contain direct or indirect entity references to external entities."
+ *   https://www.w3.org/TR/xml/#NoExternalRefs
+ *
+ * - [WFC: No < in Attribute Values]
+ *   "The replacement text of any entity referred to directly or indirectly in an attribute value MUST NOT contain a <."
+ *   https://www.w3.org/TR/xml/#CleanAttrVals
+ *
+ * - [WFC: Entity Declared]
+ *   "In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with standalone='yes', for an entity reference that does not occur within the external subset or a parameter entity, the Name given in the entity reference MUST match that in an entity declaration..."
+ *   https://www.w3.org/TR/xml/#wf-entdeclared
+ *
+ * - [WFC: Parsed Entity]
+ *   "An internal general parsed entity MUST match the production content."
+ *   https://www.w3.org/TR/xml/#textent
+ *
+ * - [WFC: No Recursion]
+ *   "A parsed entity MUST NOT contain a recursive reference to itself, either directly or indirectly."
+ *   https://www.w3.org/TR/xml/#norecursion
+ *
+ * - [WFC: In DTD]
+ *   "Parameter-entity references MUST NOT occur outside the DTD."
+ *   https://www.w3.org/TR/xml/#indtd
+ */
+export declare const grammar: import("./grammar").Grammar;
+export declare const g_deprecated: GrammarBuilder;

package/dist/cst/xml-grammar.js

@@ -0,0 +1,366 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.g_deprecated = exports.grammar = void 0;
+const grammar_1 = require("./grammar");
+const g = new grammar_1.GrammarBuilder();
+const SQ = "\u0027"; // Single Quote '
+const DQ = "\u0022"; // Double Quote "
+// [1] document ::= prolog element Misc*
+//
+// Summary:
+// - Single Root Element: There is exactly one root element that contains all other elements within the document.
+// - Proper Nesting: All elements must be correctly nested, with start and end tags forming non-overlapping, paired structures.
+// - Clear Parent-Child Hierarchy: Every non-root element has exactly one parent, creating a well-defined tree structure.
+//
+// cf: https://www.w3.org/TR/xml/#NT-document
+g.rule("document", (0, grammar_1.seq)((0, grammar_1.ref)("prolog"), (0, grammar_1.ref)("element"), (0, grammar_1.rep)((0, grammar_1.ref)("Misc"))));
+// [2] Char ::= #x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF]
+//
+// any Unicode character, excluding the surrogate blocks, FFFE, and FFFF.
+//
+// cf: https://www.w3.org/TR/xml/#NT-Char
+g.rule("Char", (0, grammar_1.reg)("\t|\n|\r|[\u0020-\uD7FF]|[\uE000-\uFFFD]|[\uD800-\uDBFF][\uDC00-\uDFFF]"));
+// [3] S ::= (#x20 | #x9 | #xD | #xA)+
+// cf: https://www.w3.org/TR/xml/#NT-S
+g.rule("S", (0, grammar_1.plus)((0, grammar_1.reg)("[\x20\t\r\n]")));
+// [4] NameStartChar ::= ":" | [A-Z] | "_" | [a-z] | [#xC0-#xD6] | [#xD8-#xF6] | [#xF8-#x2FF] | [#x370-#x37D] | [#x37F-#x1FFF] | [#x200C-#x200D] | [#x2070-#x218F] | [#x2C00-#x2FEF] | [#x3001-#xD7FF] | [#xF900-#xFDCF] | [#xFDF0-#xFFFD] | [#x10000-#xEFFFF]
+// cf: https://www.w3.org/TR/xml/#NT-NameStartChar
+g.rule("NameStartChar", (0, grammar_1.alt)((0, grammar_1.lit)(":"), (0, grammar_1.reg)("[A-Z]"), (0, grammar_1.lit)("_"), (0, grammar_1.reg)("[a-z]"), (0, grammar_1.reg)("[\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD]"), (0, grammar_1.reg)("[\uD800-\uDB7F][\uDC00-\uDFFF]")));
+// [4a] NameChar ::= NameStartChar | "-" | "." | [0-9] | #xB7 | [#x0300-#x036F] | [#x203F-#x2040]
+// cf: https://www.w3.org/TR/xml/#NT-NameChar
+g.rule("NameChar", (0, grammar_1.alt)((0, grammar_1.ref)("NameStartChar"), (0, grammar_1.lit)("-"), (0, grammar_1.lit)("."), (0, grammar_1.reg)("[0-9]"), (0, grammar_1.lit)("\u00B7"), (0, grammar_1.reg)("[\u0300-\u036F\u203F-\u2040]")));
+// [5] Name ::= NameStartChar (NameChar)*
+// cf: https://www.w3.org/TR/xml/#NT-Name
+g.rule("Name", (0, grammar_1.seq)((0, grammar_1.ref)("NameStartChar"), (0, grammar_1.rep)((0, grammar_1.ref)("NameChar"))));
+// [6] Names ::= Name (#x20 Name)*
+// cf: https://www.w3.org/TR/xml/#NT-Names
+g.rule("Names", (0, grammar_1.seq)((0, grammar_1.ref)("Name"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.lit)("\x20"), (0, grammar_1.ref)("Name")))));
+// [7] Nmtoken ::= (NameChar)+
+// cf: https://www.w3.org/TR/xml/#NT-Nmtoken
+g.rule("Nmtoken", (0, grammar_1.plus)((0, grammar_1.ref)("NameChar")));
+// [8] Nmtokens ::= Nmtoken (#x20 Nmtoken)*
+// cf: https://www.w3.org/TR/xml/#NT-Nmtokens
+g.rule("Nmtokens", (0, grammar_1.seq)((0, grammar_1.ref)("Nmtoken"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.lit)(" "), (0, grammar_1.ref)("Nmtoken")))));
+// [9] EntityValue ::= '"' ([^%&"] | PEReference | Reference)* '"' |  "'" ([^%&'] | PEReference | Reference)* "'"
+// cf: https://www.w3.org/TR/xml/#NT-EntityValue
+g.rule("EntityValue", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.reg)("[^%&\\x22]"), (0, grammar_1.ref)("PEReference"), (0, grammar_1.ref)("Reference"))), (0, grammar_1.lit)(DQ)), (0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.reg)("[^%&\\x27]"), (0, grammar_1.ref)("PEReference"), (0, grammar_1.ref)("Reference"))), (0, grammar_1.lit)(SQ))));
+// [10] AttValue ::= '"' ([^<&"] | Reference)* '"' |  "'" ([^<&'] | Reference)* "'"
+// cf: https://www.w3.org/TR/xml/#NT-AttValue
+g.rule("AttValue", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.reg)("[^<&\\x22]"), (0, grammar_1.ref)("Reference"))), (0, grammar_1.lit)(DQ)), (0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.reg)("[^<&\\x27]"), (0, grammar_1.ref)("Reference"))), (0, grammar_1.lit)(SQ))));
+// [11] SystemLiteral ::= ('"' [^\"]* "'") | ("'" [^']* "'")
+// cf: https://www.w3.org/TR/xml/#NT-SystemLiteral
+g.rule("SystemLiteral", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.reg)("[^\\x22]*"), (0, grammar_1.lit)(DQ)), (0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.reg)("[^\\x27]*"), (0, grammar_1.lit)(SQ))));
+// [12] PubidLiteral ::= '"' PubidChar* '"' | "'" (PubidChar - "'")* "'"
+// cf: https://www.w3.org/TR/xml/#NT-PubidLiteral
+g.rule("PubidLiteral", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.rep)((0, grammar_1.ref)("PubidChar")), (0, grammar_1.lit)(DQ)), (0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.rep)((0, grammar_1.exc)((0, grammar_1.ref)("PubidChar"), (0, grammar_1.lit)(SQ))), (0, grammar_1.lit)(SQ))));
+// [13] PubidChar ::= #x20 | #xD | #xA | [a-zA-Z0-9] | [-'()+,./:=?;!*#@$_%]
+// cf: https://www.w3.org/TR/xml/#NT-PubidChar
+g.rule("PubidChar", (0, grammar_1.reg)("[\\x20\\r\\na-zA-Z0-9-&#039;()+,./:=?;!*#@$_%]"));
+// [14] CharData ::= [^<&]* - ([^<&]* ']]>' [^<&]*)
+// cf: https://www.w3.org/TR/xml/#NT-CharData
+g.rule("CharData", (0, grammar_1.rep)((0, grammar_1.exc)((0, grammar_1.reg)("[^<&]"), (0, grammar_1.lit)("]]\x3E"))));
+// [15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'
+// cf: https://www.w3.org/TR/xml/#NT-Comment
+g.rule("Comment", (0, grammar_1.seq)((0, grammar_1.lit)("<!--"), (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.exc)((0, grammar_1.ref)("Char"), (0, grammar_1.lit)("-")), (0, grammar_1.seq)((0, grammar_1.lit)("-"), (0, grammar_1.exc)((0, grammar_1.ref)("Char"), (0, grammar_1.lit)("-"))))), (0, grammar_1.lit)("-->")));
+// [16] PI ::= '<?' PITarget (S (Char* - (Char* '?>' Char*)))? '?>'
+// cf: https://www.w3.org/TR/xml/#NT-PI
+g.rule("PI", (0, grammar_1.seq)((0, grammar_1.lit)("<?"), (0, grammar_1.ref)("PITarget"), (0, grammar_1.opt)((0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.rep)((0, grammar_1.exc)((0, grammar_1.ref)("Char"), (0, grammar_1.lit)("?>"))))), (0, grammar_1.lit)("?>")));
+// [17] PITarget ::= Name - ((('X' | 'x') ('M' | 'm') ('L' | 'l')))
+// cf: https://www.w3.org/TR/xml/#NT-PITarget
+g.rule("PITarget", (0, grammar_1.exc)((0, grammar_1.ref)("Name"), (0, grammar_1.reg)("([Xx][Mm][Ll])")));
+// [18] CDSect ::= CDStart CData CDEnd
+// cf: https://www.w3.org/TR/xml/#NT-CDSect
+g.rule("CDSect", (0, grammar_1.seq)((0, grammar_1.ref)("CDStart"), (0, grammar_1.ref)("CData"), (0, grammar_1.ref)("CDEnd")));
+// [19] CDStart ::= '<![CDATA['
+// cf: https://www.w3.org/TR/xml/#NT-CDStart
+g.rule("CDStart", (0, grammar_1.lit)("<![CDATA["));
+// [20] CData ::= (Char* - (Char* ']]>' Char*))
+// cf: https://www.w3.org/TR/xml/#NT-CData
+g.rule("CData", (0, grammar_1.rep)((0, grammar_1.exc)((0, grammar_1.ref)("Char"), (0, grammar_1.lit)("]]\x3E"))));
+// [21] CDEnd ::= ']]>'
+// cf: https://www.w3.org/TR/xml/#NT-CDEnd
+g.rule("CDEnd", (0, grammar_1.lit)("]]\x3E"));
+// [22] prolog ::= XMLDecl? Misc* (doctypedecl Misc*)?
+// cf: https://www.w3.org/TR/xml/#NT-prolog
+g.rule("prolog", (0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("XMLDecl")), (0, grammar_1.rep)((0, grammar_1.ref)("Misc")), (0, grammar_1.opt)((0, grammar_1.seq)((0, grammar_1.ref)("doctypedecl"), (0, grammar_1.rep)((0, grammar_1.ref)("Misc"))))));
+// [23] XMLDecl ::= '<?xml' VersionInfo EncodingDecl? SDDecl? S? '?>'
+// cf: https://www.w3.org/TR/xml/#NT-XMLDecl
+g.rule("XMLDecl", (0, grammar_1.seq)((0, grammar_1.lit)("<?xml"), (0, grammar_1.ref)("VersionInfo"), (0, grammar_1.opt)((0, grammar_1.ref)("EncodingDecl")), (0, grammar_1.opt)((0, grammar_1.ref)("SDDecl")), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("?>")));
+// [24] VersionInfo ::= S 'version' Eq (("'" VersionNum "'") | ('"' VersionNum "'"))
+// cf: https://www.w3.org/TR/xml/#NT-VersionInfo
+g.rule("VersionInfo", (0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.lit)("version"), (0, grammar_1.ref)("Eq"), (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.ref)("VersionNum"), (0, grammar_1.lit)(SQ)), (0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.ref)("VersionNum"), (0, grammar_1.lit)(DQ)))));
+// [25] Eq ::= S? '=' S?
+// cf: https://www.w3.org/TR/xml/#NT-Eq
+g.rule("Eq", (0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("="), (0, grammar_1.opt)((0, grammar_1.ref)("S"))));
+// [26] VersionNum ::= '1.' [0-9]+
+// cf: https://www.w3.org/TR/xml/#NT-VersionNum
+g.rule("VersionNum", (0, grammar_1.seq)((0, grammar_1.lit)("1."), (0, grammar_1.plus)((0, grammar_1.reg)("[0-9]"))));
+// [27] Misc ::= Comment | PI | S
+// cf: https://www.w3.org/TR/xml/#NT-Misc
+g.rule("Misc", (0, grammar_1.alt)((0, grammar_1.ref)("Comment"), (0, grammar_1.ref)("PI"), (0, grammar_1.ref)("S")));
+// [28] doctypedecl ::= '<!DOCTYPE' S Name (S ExternalID)? S? ('[' intSubset ']' S?)? '>'
+// cf: https://www.w3.org/TR/xml/#NT-doctypedecl
+g.rule("doctypedecl", (0, grammar_1.seq)((0, grammar_1.lit)("<!DOCTYPE"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.opt)((0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.ref)("ExternalID"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.opt)((0, grammar_1.seq)((0, grammar_1.lit)("["), (0, grammar_1.ref)("intSubset"), (0, grammar_1.lit)("]"), (0, grammar_1.opt)((0, grammar_1.ref)("S")))), (0, grammar_1.lit)(">")));
+// [28a] DeclSep ::= PEReference | S
+// cf: https://www.w3.org/TR/xml/#NT-DeclSep
+g.rule("DeclSep", (0, grammar_1.alt)((0, grammar_1.ref)("PEReference"), (0, grammar_1.ref)("S")));
+// [28b] intSubset ::= (markupdecl | DeclSep)*
+// cf: https://www.w3.org/TR/xml/#NT-intSubset
+g.rule("intSubset", (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.ref)("markupdecl"), (0, grammar_1.ref)("DeclSep"))));
+// [29] markupdecl ::= elementdecl | AttlistDecl | EntityDecl | NotationDecl | PI | Comment
+// cf: https://www.w3.org/TR/xml/#NT-markupdecl
+g.rule("markupdecl", (0, grammar_1.alt)((0, grammar_1.ref)("elementdecl"), (0, grammar_1.ref)("AttlistDecl"), (0, grammar_1.ref)("EntityDecl"), (0, grammar_1.ref)("NotationDecl"), (0, grammar_1.ref)("PI"), (0, grammar_1.ref)("Comment")));
+// [30] extSubset ::= TextDecl? extSubsetDecl
+// cf: https://www.w3.org/TR/xml/#NT-extSubset
+g.rule("extSubset", (0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("TextDecl")), (0, grammar_1.ref)("extSubsetDecl")));
+// [31] extSubsetDecl ::= ( markupdecl | conditionalSect | DeclSep)*
+// cf: https://www.w3.org/TR/xml/#NT-extSubsetDecl
+g.rule("extSubsetDecl", (0, grammar_1.rep)((0, grammar_1.alt)((0, grammar_1.ref)("markupdecl"), (0, grammar_1.ref)("conditionalSect"), (0, grammar_1.ref)("DeclSep"))));
+// [32] SDDecl ::= S 'standalone' Eq (("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no') "'"))
+// cf: https://www.w3.org/TR/xml/#NT-SDDecl
+g.rule("SDDecl", (0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.lit)("standalone"), (0, grammar_1.ref)("Eq"), (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.alt)((0, grammar_1.lit)("yes"), (0, grammar_1.lit)("no")), (0, grammar_1.lit)(SQ)), (0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.alt)((0, grammar_1.lit)("yes"), (0, grammar_1.lit)("no")), (0, grammar_1.lit)(DQ)))));
+// [39] element ::= EmptyElemTag | STag content ETag
+// cf: https://www.w3.org/TR/xml/#NT-element
+g.rule("element", (0, grammar_1.alt)((0, grammar_1.ref)("EmptyElemTag"), (0, grammar_1.seq)((0, grammar_1.ref)("STag"), (0, grammar_1.ref)("content"), (0, grammar_1.ref)("ETag"))));
+// Well-formedness constraint: Element Type Match
+function validateElementTypeMatch(node, input) {
+    const structuralNode = node.unwrap();
+    // Case 1: EmptyElemTag (always well-formed regarding tag match)
+    if (structuralNode.children.length > 0 &&
+        structuralNode.children[0].type === "literal") {
+        return true;
+    }
+    // Case 2: Sequence [STag, content, ETag]
+    if (structuralNode.children.length === 3 &&
+        structuralNode.children[0].name === "STag" &&
+        structuralNode.children[2].name === "ETag") {
+        const stag = structuralNode.children[0];
+        const etag = structuralNode.children[2];
+        const startName = stag.unwrap().children[1].getText(input);
+        const endName = etag.unwrap().children[1].getText(input);
+        return startName === endName;
+    }
+    throw new Error(`Validation error: unexpected node structure in validateElementTypeMatch. Children types: ${structuralNode.children.map((c) => c.type).join(", ")}`);
+}
+g.verifyRule("element", validateElementTypeMatch);
+// Helper for Unique Att Spec check
+function validateUniqueAttributes(node, input) {
+    const seen = new Set();
+    const structuralNode = node.unwrap();
+    // STag/EmptyElemTag structure:
+    // 0: "<"
+    // 1: Name
+    // 2: rep(seq(S, Attribute))
+    // ...
+    const repNode = structuralNode.children[2];
+    if (!repNode || repNode.type !== "repeat")
+        return true;
+    for (const seqNode of repNode.children) {
+        // seqNode children: [S, Attribute]
+        const attrNode = seqNode.children[1];
+        if (attrNode && attrNode.name === "Attribute") {
+            const attrStructural = attrNode.unwrap();
+            const nameNode = attrStructural.children[0];
+            const name = nameNode.getText(input);
+            if (seen.has(name))
+                return false;
+            seen.add(name);
+        }
+    }
+    return true;
+}
+// [40] STag ::= '<' Name (S Attribute)* S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-STag
+g.rule("STag", (0, grammar_1.seq)((0, grammar_1.lit)("<"), (0, grammar_1.ref)("Name"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.ref)("Attribute"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// Well-formedness constraint: Unique Att Spec
+g.verifyRule("STag", validateUniqueAttributes);
+// [41] Attribute ::= Name Eq AttValue
+// cf: https://www.w3.org/TR/xml/#NT-Attribute
+g.rule("Attribute", (0, grammar_1.seq)((0, grammar_1.ref)("Name"), (0, grammar_1.ref)("Eq"), (0, grammar_1.ref)("AttValue")));
+// [42] ETag ::= '</' Name S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-ETag
+g.rule("ETag", (0, grammar_1.seq)((0, grammar_1.lit)("</"), (0, grammar_1.ref)("Name"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// [43] content ::= CharData? ((element | Reference | CDSect | PI | Comment) CharData?)*
+// cf: https://www.w3.org/TR/xml/#NT-content
+g.rule("content", (0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("CharData")), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.alt)((0, grammar_1.ref)("element"), (0, grammar_1.ref)("Reference"), (0, grammar_1.ref)("CDSect"), (0, grammar_1.ref)("PI"), (0, grammar_1.ref)("Comment")), (0, grammar_1.opt)((0, grammar_1.ref)("CharData"))))));
+// [44] EmptyElemTag ::= '<' Name (S Attribute)* S? '/>'
+// cf: https://www.w3.org/TR/xml/#NT-EmptyElemTag
+g.rule("EmptyElemTag", (0, grammar_1.seq)((0, grammar_1.lit)("<"), (0, grammar_1.ref)("Name"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.ref)("Attribute"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("/>")));
+// Well-formedness constraint: Unique Att Spec
+g.verifyRule("EmptyElemTag", validateUniqueAttributes);
+// [45] elementdecl ::= '<!ELEMENT' S Name S contentspec S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-elementdecl
+g.rule("elementdecl", (0, grammar_1.seq)((0, grammar_1.lit)("<!ELEMENT"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("contentspec"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// [46] contentspec ::= 'EMPTY' | 'ANY' | Mixed | children
+// cf: https://www.w3.org/TR/xml/#NT-contentspec
+g.rule("contentspec", (0, grammar_1.alt)((0, grammar_1.lit)("EMPTY"), (0, grammar_1.lit)("ANY"), (0, grammar_1.ref)("Mixed"), (0, grammar_1.ref)("children")));
+// [47] children ::= (choice | seq) ('?' | '*' | '+')?
+// cf: https://www.w3.org/TR/xml/#NT-children
+g.rule("children", (0, grammar_1.seq)((0, grammar_1.alt)((0, grammar_1.ref)("choice"), (0, grammar_1.ref)("seq")), (0, grammar_1.opt)((0, grammar_1.reg)("[?*+]?"))));
+// [48] cp ::= (Name | choice | seq) ('?' | '*' | '+')?
+// cf: https://www.w3.org/TR/xml/#NT-cp
+g.rule("cp", (0, grammar_1.seq)((0, grammar_1.alt)((0, grammar_1.ref)("Name"), (0, grammar_1.ref)("choice"), (0, grammar_1.ref)("seq")), (0, grammar_1.opt)((0, grammar_1.reg)("[?*+]?"))));
+// [49] choice ::= '(' S? cp ( S? '|' S? cp )+ S? ')'
+// cf: https://www.w3.org/TR/xml/#NT-choice
+g.rule("choice", (0, grammar_1.seq)((0, grammar_1.lit)("("), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("cp"), (0, grammar_1.plus)((0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("|"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("cp"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(")")));
+// [50] seq ::= '(' S? cp ( S? ',' S? cp )* S? ')'
+// cf: https://www.w3.org/TR/xml/#NT-seq
+g.rule("seq", (0, grammar_1.seq)((0, grammar_1.lit)("("), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("cp"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(","), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("cp"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(")")));
+// [51] Mixed ::= '(' S? '#PCDATA' (S? '|' S? Name)* S? ')*' | '(' S? '#PCDATA' S? ')'
+// cf: https://www.w3.org/TR/xml/#NT-Mixed
+g.rule("Mixed", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)("("), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("#PCDATA"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("|"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("Name"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(")*")), (0, grammar_1.seq)((0, grammar_1.lit)("("), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("#PCDATA"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(")"))));
+// [52] AttlistDecl ::= '<!ATTLIST' S Name AttDef* S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-AttlistDecl
+g.rule("AttlistDecl", (0, grammar_1.seq)((0, grammar_1.lit)("<!ATTLIST"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.rep)((0, grammar_1.ref)("AttDef")), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// [53] AttDef ::= S Name S AttType S DefaultDecl
+// cf: https://www.w3.org/TR/xml/#NT-AttDef
+g.rule("AttDef", (0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("AttType"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("DefaultDecl")));
+// [54] AttType ::= StringType | TokenizedType | EnumeratedType
+// cf: https://www.w3.org/TR/xml/#NT-AttType
+g.rule("AttType", (0, grammar_1.alt)((0, grammar_1.ref)("StringType"), (0, grammar_1.ref)("TokenizedType"), (0, grammar_1.ref)("EnumeratedType")));
+// [55] StringType ::= 'CDATA'
+// cf: https://www.w3.org/TR/xml/#NT-StringType
+g.rule("StringType", (0, grammar_1.lit)("CDATA"));
+// [56] TokenizedType ::= 'ID' | 'IDREF' | 'IDREFS' | 'ENTITY' | 'ENTITIES' | 'NMTOKEN' | 'NMTOKENS'
+// cf: https://www.w3.org/TR/xml/#NT-TokenizedType
+g.rule("TokenizedType", (0, grammar_1.alt)((0, grammar_1.lit)("ID"), (0, grammar_1.lit)("IDREF"), (0, grammar_1.lit)("IDREFS"), (0, grammar_1.lit)("ENTITY"), (0, grammar_1.lit)("ENTITIES"), (0, grammar_1.lit)("NMTOKEN"), (0, grammar_1.lit)("NMTOKENS")));
+// [57] EnumeratedType ::= NotationType | Enumeration
+// cf: https://www.w3.org/TR/xml/#NT-EnumeratedType
+g.rule("EnumeratedType", (0, grammar_1.alt)((0, grammar_1.ref)("NotationType"), (0, grammar_1.ref)("Enumeration")));
+// [58] NotationType ::= 'NOTATION' S '(' S? Name (S? '|' S? Name)* S? ')'
+// cf: https://www.w3.org/TR/xml/#NT-NotationType
+g.rule("NotationType", (0, grammar_1.seq)((0, grammar_1.lit)("NOTATION"), (0, grammar_1.ref)("S"), (0, grammar_1.lit)("("), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("Name"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("|"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("Name"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(")")));
+// [59] Enumeration ::= '(' S? Nmtoken (S? '|' S? Nmtoken)* S? ')'
+// cf: https://www.w3.org/TR/xml/#NT-Enumeration
+g.rule("Enumeration", (0, grammar_1.seq)((0, grammar_1.lit)("("), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("Nmtoken"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("|"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.ref)("Nmtoken"))), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(")")));
+// [60] DefaultDecl ::= '#REQUIRED' | '#IMPLIED' | (('#FIXED' S)? AttValue)
+// cf: https://www.w3.org/TR/xml/#NT-DefaultDecl
+g.rule("DefaultDecl", (0, grammar_1.alt)((0, grammar_1.lit)("#REQUIRED"), (0, grammar_1.lit)("#IMPLIED"), (0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.seq)((0, grammar_1.lit)("#FIXED"), (0, grammar_1.ref)("S"))), (0, grammar_1.ref)("AttValue"))));
+// [61] conditionalSect ::= includeSect | ignoreSect
+// cf: https://www.w3.org/TR/xml/#NT-conditionalSect
+g.rule("conditionalSect", (0, grammar_1.alt)((0, grammar_1.ref)("includeSect"), (0, grammar_1.ref)("ignoreSect")));
+// [62] includeSect ::= '<![' S? 'INCLUDE' S? '[' extSubsetDecl ']]>'
+// cf: https://www.w3.org/TR/xml/#NT-includeSect
+g.rule("includeSect", (0, grammar_1.seq)((0, grammar_1.lit)("<!["), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("INCLUDE"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("["), (0, grammar_1.ref)("extSubsetDecl"), (0, grammar_1.lit)("]]\x3E")));
+// [63] ignoreSect ::= '<![' S? 'IGNORE' S? '[' ignoreSectContents* ']]>'
+// cf: https://www.w3.org/TR/xml/#NT-ignoreSect
+g.rule("ignoreSect", (0, grammar_1.seq)((0, grammar_1.lit)("<!["), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("IGNORE"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("["), (0, grammar_1.rep)((0, grammar_1.ref)("ignoreSectContents")), (0, grammar_1.lit)("]]\x3E")));
+// [64] ignoreSectContents ::= Ignore ('<![' ignoreSectContents ']]>' Ignore)*
+// cf: https://www.w3.org/TR/xml/#NT-ignoreSectContents
+g.rule("ignoreSectContents", (0, grammar_1.seq)((0, grammar_1.ref)("Ignore"), (0, grammar_1.rep)((0, grammar_1.seq)((0, grammar_1.lit)("<!["), (0, grammar_1.ref)("ignoreSectContents"), (0, grammar_1.lit)("]]\x3E"), (0, grammar_1.ref)("Ignore")))));
+// [65] Ignore ::= Char* - (Char* ('<![' | ']]>') Char*)
+// cf: https://www.w3.org/TR/xml/#NT-Ignore
+g.rule("Ignore", (0, grammar_1.rep)((0, grammar_1.exc)((0, grammar_1.ref)("Char"), (0, grammar_1.reg)("(<![|]]\\x3E)"))));
+// [66] CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';'
+// cf: https://www.w3.org/TR/xml/#NT-CharRef
+g.rule("CharRef", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)("&#"), (0, grammar_1.plus)((0, grammar_1.reg)("[0-9]")), (0, grammar_1.lit)(";")), (0, grammar_1.seq)((0, grammar_1.lit)("&#x"), (0, grammar_1.plus)((0, grammar_1.reg)("[0-9a-fA-F]")), (0, grammar_1.lit)(";"))));
+// Well-formedness constraint: Legal Character
+// Characters referred to using character references MUST match the production for Char.
+g.verifyRule("CharRef", (node, input) => {
+    const text = node.getText(input);
+    let code;
+    if (text.startsWith("&#x")) {
+        code = parseInt(text.slice(3, -1), 16);
+    }
+    else {
+        code = parseInt(text.slice(2, -1), 10);
+    }
+    return (code === 0x9 ||
+        code === 0xa ||
+        code === 0xd ||
+        (code >= 0x20 && code <= 0xd7ff) ||
+        (code >= 0xe000 && code <= 0xfffd) ||
+        (code >= 0x10000 && code <= 0x10ffff));
+});
+// [67] Reference ::= EntityRef | CharRef
+// cf: https://www.w3.org/TR/xml/#NT-Reference
+g.rule("Reference", (0, grammar_1.alt)((0, grammar_1.ref)("EntityRef"), (0, grammar_1.ref)("CharRef")));
+// [68] EntityRef ::= '&' Name ';'
+// cf: https://www.w3.org/TR/xml/#NT-EntityRef
+g.rule("EntityRef", (0, grammar_1.seq)((0, grammar_1.lit)("&"), (0, grammar_1.ref)("Name"), (0, grammar_1.lit)(";")));
+// [69] PEReference ::= '%' Name ';'
+// cf: https://www.w3.org/TR/xml/#NT-PEReference
+g.rule("PEReference", (0, grammar_1.seq)((0, grammar_1.lit)("%"), (0, grammar_1.ref)("Name"), (0, grammar_1.lit)(";")));
+// [70] EntityDecl ::= GEDecl | PEDecl
+// cf: https://www.w3.org/TR/xml/#NT-EntityDecl
+g.rule("EntityDecl", (0, grammar_1.alt)((0, grammar_1.ref)("GEDecl"), (0, grammar_1.ref)("PEDecl")));
+// [71] GEDecl ::= '<!ENTITY' S Name S EntityDef S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-GEDecl
+g.rule("GEDecl", (0, grammar_1.seq)((0, grammar_1.lit)("<!ENTITY"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("EntityDef"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// [72] PEDecl ::= '<!ENTITY' S '%' S Name S PEDef S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-PEDecl
+g.rule("PEDecl", (0, grammar_1.seq)((0, grammar_1.lit)("<!ENTITY"), (0, grammar_1.ref)("S"), (0, grammar_1.lit)("%"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("PEDef"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// [73] EntityDef ::= EntityValue | (ExternalID NDataDecl?)
+// cf: https://www.w3.org/TR/xml/#NT-EntityDef
+g.rule("EntityDef", (0, grammar_1.alt)((0, grammar_1.ref)("EntityValue"), (0, grammar_1.seq)((0, grammar_1.ref)("ExternalID"), (0, grammar_1.opt)((0, grammar_1.ref)("NDataDecl")))));
+// [74] PEDef ::= EntityValue | ExternalID
+// cf: https://www.w3.org/TR/xml/#NT-PEDef
+g.rule("PEDef", (0, grammar_1.alt)((0, grammar_1.ref)("EntityValue"), (0, grammar_1.ref)("ExternalID")));
+// [75] ExternalID ::= 'SYSTEM' S SystemLiteral | 'PUBLIC' S PubidLiteral S SystemLiteral
+// cf: https://www.w3.org/TR/xml/#NT-ExternalID
+g.rule("ExternalID", (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)("SYSTEM"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("SystemLiteral")), (0, grammar_1.seq)((0, grammar_1.lit)("PUBLIC"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("PubidLiteral"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("SystemLiteral"))));
+// [76] NDataDecl ::= S 'NDATA' S Name
+// cf: https://www.w3.org/TR/xml/#NT-NDataDecl
+g.rule("NDataDecl", (0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.lit)("NDATA"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name")));
+// [77] TextDecl ::= '<?xml' VersionInfo? EncodingDecl S? '?>'
+// cf: https://www.w3.org/TR/xml/#NT-TextDecl
+g.rule("TextDecl", (0, grammar_1.seq)((0, grammar_1.lit)("<?xml"), (0, grammar_1.opt)((0, grammar_1.ref)("VersionInfo")), (0, grammar_1.ref)("EncodingDecl"), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)("?>")));
+// [78] extParsedEnt ::= TextDecl? content
+// cf: https://www.w3.org/TR/xml/#NT-extParsedEnt
+g.rule("extParsedEnt", (0, grammar_1.seq)((0, grammar_1.opt)((0, grammar_1.ref)("TextDecl")), (0, grammar_1.ref)("content")));
+// [80] EncodingDecl ::= S 'encoding' Eq ('"' EncName "'" | "'" EncName "'")
+// cf: https://www.w3.org/TR/xml/#NT-EncodingDecl
+g.rule("EncodingDecl", (0, grammar_1.seq)((0, grammar_1.ref)("S"), (0, grammar_1.lit)("encoding"), (0, grammar_1.ref)("Eq"), (0, grammar_1.alt)((0, grammar_1.seq)((0, grammar_1.lit)(DQ), (0, grammar_1.ref)("EncName"), (0, grammar_1.lit)(DQ)), (0, grammar_1.seq)((0, grammar_1.lit)(SQ), (0, grammar_1.ref)("EncName"), (0, grammar_1.lit)(SQ)))));
+// [81] EncName ::= [A-Za-z] ([A-Za-z0-9._] | '-')*
+// cf: https://www.w3.org/TR/xml/#NT-EncName
+g.rule("EncName", (0, grammar_1.seq)((0, grammar_1.reg)("[A-Za-z]"), (0, grammar_1.rep)((0, grammar_1.reg)("[A-Za-z0-9._-]"))));
+// [82] NotationDecl ::= '<!NOTATION' S Name S (ExternalID | PublicID) S? '>'
+// cf: https://www.w3.org/TR/xml/#NT-NotationDecl
+g.rule("NotationDecl", (0, grammar_1.seq)((0, grammar_1.lit)("<!NOTATION"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("Name"), (0, grammar_1.ref)("S"), (0, grammar_1.alt)((0, grammar_1.ref)("ExternalID"), (0, grammar_1.ref)("PublicID")), (0, grammar_1.opt)((0, grammar_1.ref)("S")), (0, grammar_1.lit)(">")));
+// [83] PublicID ::= 'PUBLIC' S PubidLiteral
+// cf: https://www.w3.org/TR/xml/#NT-PublicID
+g.rule("PublicID", (0, grammar_1.seq)((0, grammar_1.lit)("PUBLIC"), (0, grammar_1.ref)("S"), (0, grammar_1.ref)("PubidLiteral")));
+/**
+ * Unimplemented Well-formedness Constraints (WFC)
+ *
+ * The following constraints are currently not enforced by this parser.
+ * Implementation would require an Entity Manager, DTD Processor, and extended Context.
+ *
+ * - [WFC: PEs in Internal Subset]
+ *   "In the internal DTD subset, parameter-entity references MUST NOT occur within markup declarations..."
+ *   https://www.w3.org/TR/xml/#wfc-PEinInternalSubset
+ *
+ * - [WFC: External Subset]
+ *   "The external subset, if any, MUST match the production for extSubset."
+ *   https://www.w3.org/TR/xml/#ExtSubset
+ *
+ * - [WFC: PE Between Declarations]
+ *   "The replacement text of a parameter entity reference in a DeclSep MUST match the production extSubsetDecl."
+ *   https://www.w3.org/TR/xml/#PE-between-Decls
+ *
+ * - [WFC: No External Entity References]
+ *   "Attribute values MUST NOT contain direct or indirect entity references to external entities."
+ *   https://www.w3.org/TR/xml/#NoExternalRefs
+ *
+ * - [WFC: No < in Attribute Values]
+ *   "The replacement text of any entity referred to directly or indirectly in an attribute value MUST NOT contain a <."
+ *   https://www.w3.org/TR/xml/#CleanAttrVals
+ *
+ * - [WFC: Entity Declared]
+ *   "In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with standalone='yes', for an entity reference that does not occur within the external subset or a parameter entity, the Name given in the entity reference MUST match that in an entity declaration..."
+ *   https://www.w3.org/TR/xml/#wf-entdeclared
+ *
+ * - [WFC: Parsed Entity]
+ *   "An internal general parsed entity MUST match the production content."
+ *   https://www.w3.org/TR/xml/#textent
+ *
+ * - [WFC: No Recursion]
+ *   "A parsed entity MUST NOT contain a recursive reference to itself, either directly or indirectly."
+ *   https://www.w3.org/TR/xml/#norecursion
+ *
+ * - [WFC: In DTD]
+ *   "Parameter-entity references MUST NOT occur outside the DTD."
+ *   https://www.w3.org/TR/xml/#indtd
+ */
+exports.grammar = g.build();
+exports.g_deprecated = g;