fix: declare getMetaDataSymbol() as returning symbol | string

lib/fxp.d.cts

@@ -723,7 +723,7 @@ declare class XMLParser {
    * The XMLMetaData property is only present when {@link X2jOptions.captureMetaData}
    * is true in the options.
    */
-  static getMetaDataSymbol(): Symbol;
+  static getMetaDataSymbol(): symbol | string;
 }
 
 declare class XMLValidator {

spec/typings/typings-test.ts

@@ -41,6 +41,18 @@ const parsed = parser.parse(XML);
 
 console.log(!!parsed);
 
+// The metadata key indexes parsed nodes, so it has to be a primitive property key, not a boxed `Symbol`.
+const metaDataKey: PropertyKey = XMLParser.getMetaDataSymbol();
+const metaDataNode = new XMLParser({ captureMetaData: true }).parse(XML).SomeElement;
+
+console.log(metaDataNode[metaDataKey], metaDataNode[XMLParser.getMetaDataSymbol()]);
+
+// Without `Symbol` in the environment the key falls back to a plain property name.
+type StringKeyAccepted = string extends ReturnType<typeof XMLParser.getMetaDataSymbol> ? true : false;
+const stringKeyAccepted: StringKeyAccepted = true;
+
+console.log(stringKeyAccepted);
+
 const buildOpts: XmlBuilderOptions = {};
 
 const builder = new XMLBuilder(buildOpts);

src/fxp.d.ts

@@ -724,7 +724,7 @@ export class XMLParser {
    * The XMLMetaData property is only present when {@link X2jOptions.captureMetaData}
    * is true in the options.
    */
-  static getMetaDataSymbol(): Symbol;
+  static getMetaDataSymbol(): symbol | string;
 }
 
 /**