@markuplint/parser-utils 5.1.0 → 5.2.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.2.0](https://github.com/markuplint/markuplint/compare/v5.1.1...v5.2.0) (2026-10-13)
+
+### Bug Fixes
+
+- **parser-utils:** do not enter a namespace by the name of an authored element ([40e4d2d](https://github.com/markuplint/markuplint/commit/40e4d2d5065a7831721495d9ef2672fdddb51d93))
+- use caret ranges for third-party dependencies of published packages ([5fb5d2e](https://github.com/markuplint/markuplint/commit/5fb5d2ee81eaeea45fe7256a40dd41c95ff0d672))
+
+### Features
+
+- **parser-utils:** add getChildNamespace and getNamespaceBelow ([88cbab7](https://github.com/markuplint/markuplint/commit/88cbab7755d4efcdc6ac8a0f6d61d209f80802e6))
+
+## [5.1.1](https://github.com/markuplint/markuplint/compare/v5.1.0...v5.1.1) (2026-10-09)
+
+**Note:** Version bump only for package @markuplint/parser-utils
+
 # [5.1.0](https://github.com/markuplint/markuplint/compare/v5.0.1...v5.1.0) (2026-10-08)
 
 **Note:** Version bump only for package @markuplint/parser-utils

package/lib/get-namespace.d.ts

@@ -4,8 +4,33 @@ import type { MLASTParentNode, NamespaceURI } from '@markuplint/ml-ast';
  * Handles namespace transitions between HTML, SVG, and MathML
  * (e.g., entering `<svg>` switches to SVG namespace, `<foreignObject>` switches back to HTML).
  *
- * @param currentNodeName - The tag name of the current node, or null for anonymous nodes
+ * @param currentNodeName - The tag name of the current node, or null for anonymous nodes and
+ *   for an authored element (a component), which does not enter a namespace by its name
  * @param parentNode - The parent node in the AST, or null for root-level nodes
  * @returns The resolved namespace URI for the node
  */
 export declare function getNamespace(currentNodeName: string | null, parentNode: MLASTParentNode | null): NamespaceURI;
+/**
+ * Determines the namespace URI for an element from its tag name and its parent element,
+ * by the same transitions as {@link getNamespace}. For a caller that knows the parent's
+ * name and namespace but has no AST node for it.
+ *
+ * @param currentNodeName - The tag name of the element, or null to take the namespace its parent gives any element
+ * @param parentNamespace - The namespace URI of the parent element (HTML at the top level)
+ * @param parentNodeName - The tag name of the parent element, or null at the top level
+ * @returns The resolved namespace URI for the element
+ */
+export declare function getChildNamespace(currentNodeName: string | null, parentNamespace: NamespaceURI, parentNodeName: string | null): NamespaceURI;
+/**
+ * Determines the namespace URI of an element below an ancestor whose own namespace is not
+ * known, such as the root of a component, which takes the namespace of where it is used.
+ *
+ * It is known once the ancestor or the elements between them cross a transition: an `svg`
+ * or `math` is taken to enter its namespace, as it does from HTML, and an element below
+ * `foreignObject` is HTML whether the `foreignObject` is in SVG or in HTML.
+ *
+ * @param ancestorName - The tag name of the ancestor, or null for a component or fragment
+ * @param names - The tag names from the child of the ancestor down to the element, null for a component
+ * @returns The namespace URI of the element, or null when it depends on where the ancestor is
+ */
+export declare function getNamespaceBelow(ancestorName: string | null, names: readonly (string | null)[]): NamespaceURI | null;

package/lib/get-namespace.js

@@ -3,22 +3,69 @@
  * Handles namespace transitions between HTML, SVG, and MathML
  * (e.g., entering `<svg>` switches to SVG namespace, `<foreignObject>` switches back to HTML).
  *
- * @param currentNodeName - The tag name of the current node, or null for anonymous nodes
+ * @param currentNodeName - The tag name of the current node, or null for anonymous nodes and
+ *   for an authored element (a component), which does not enter a namespace by its name
  * @param parentNode - The parent node in the AST, or null for root-level nodes
  * @returns The resolved namespace URI for the node
  */
 export function getNamespace(currentNodeName, parentNode) {
-    const parentNS = getParentNamespace(parentNode);
-    if (parentNS === 'http://www.w3.org/1999/xhtml' && currentNodeName?.toLowerCase() === 'svg') {
+    return getChildNamespace(currentNodeName, getParentNamespace(parentNode), parentNode?.nodeName ?? null);
+}
+/**
+ * Determines the namespace URI for an element from its tag name and its parent element,
+ * by the same transitions as {@link getNamespace}. For a caller that knows the parent's
+ * name and namespace but has no AST node for it.
+ *
+ * @param currentNodeName - The tag name of the element, or null to take the namespace its parent gives any element
+ * @param parentNamespace - The namespace URI of the parent element (HTML at the top level)
+ * @param parentNodeName - The tag name of the parent element, or null at the top level
+ * @returns The resolved namespace URI for the element
+ */
+export function getChildNamespace(currentNodeName, parentNamespace, parentNodeName) {
+    if (parentNamespace === 'http://www.w3.org/1999/xhtml' && currentNodeName?.toLowerCase() === 'svg') {
         return 'http://www.w3.org/2000/svg';
     }
-    else if (parentNS === 'http://www.w3.org/2000/svg' && parentNode?.nodeName === 'foreignObject') {
+    else if (parentNamespace === 'http://www.w3.org/2000/svg' && parentNodeName === 'foreignObject') {
         return 'http://www.w3.org/1999/xhtml';
     }
-    else if (parentNS === 'http://www.w3.org/1999/xhtml' && currentNodeName?.toLowerCase() === 'math') {
+    else if (parentNamespace === 'http://www.w3.org/1999/xhtml' && currentNodeName?.toLowerCase() === 'math') {
         return 'http://www.w3.org/1998/Math/MathML';
     }
-    return parentNS;
+    return parentNamespace;
+}
+/**
+ * Determines the namespace URI of an element below an ancestor whose own namespace is not
+ * known, such as the root of a component, which takes the namespace of where it is used.
+ *
+ * It is known once the ancestor or the elements between them cross a transition: an `svg`
+ * or `math` is taken to enter its namespace, as it does from HTML, and an element below
+ * `foreignObject` is HTML whether the `foreignObject` is in SVG or in HTML.
+ *
+ * @param ancestorName - The tag name of the ancestor, or null for a component or fragment
+ * @param names - The tag names from the child of the ancestor down to the element, null for a component
+ * @returns The namespace URI of the element, or null when it depends on where the ancestor is
+ */
+export function getNamespaceBelow(ancestorName, names) {
+    let namespace = getEnteredNamespace(ancestorName);
+    let parentName = ancestorName;
+    for (const name of names) {
+        if (namespace) {
+            namespace = getChildNamespace(name, namespace, parentName);
+        }
+        else {
+            namespace =
+                getEnteredNamespace(name) ?? (parentName === 'foreignObject' ? 'http://www.w3.org/1999/xhtml' : null);
+        }
+        parentName = name;
+    }
+    return namespace;
+}
+/**
+ * The namespace an element enters by its name from HTML, or null if it enters none.
+ */
+function getEnteredNamespace(name) {
+    const entered = getChildNamespace(name, 'http://www.w3.org/1999/xhtml', null);
+    return entered === 'http://www.w3.org/1999/xhtml' ? null : entered;
 }
 function getParentNamespace(parentNode) {
     if (!parentNode) {

package/lib/parser.js

@@ -1357,6 +1357,7 @@ export class Parser {
         }
         const tagToken = this.createToken(rawCodeFragment, tagStartOffset, tagStartLine, tagStartCol);
         const isFragment = tagName === '';
+        const elementType = this.detectElementType(tagName);
         const commons = {
             depth,
             nodeName: isFragment ? '#jsx-fragment' : tagName,
@@ -1368,10 +1369,13 @@ export class Parser {
                 ...tagToken,
                 ...commons,
                 type: 'starttag',
-                elementType: this.detectElementType(tagName),
+                elementType,
+                // What a component renders is not known from its name, so an authored
+                // element is not given the name: `<Svg>` and `<Math>` would enter
+                // their namespaces, as `getNamespace` compares names in lowercase.
                 namespace: 'namespace' in token
                     ? token.namespace
-                    : getNamespace(tagName, token.parentNode),
+                    : getNamespace(elementType === 'authored' ? null : tagName, token.parentNode),
                 attributes: attrs,
                 childNodes: [],
                 pairNode: null,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/parser-utils",
-	"version": "5.1.0",
+	"version": "5.2.0",
 	"description": "Utility module for markuplint parser plugin",
 	"repository": {
 		"type": "git",
@@ -35,16 +35,16 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.1.0",
-		"@markuplint/ml-spec": "5.1.0",
-		"@markuplint/shared": "5.1.0",
-		"@markuplint/types": "5.1.0",
-		"debug": "4.4.3",
-		"espree": "11.2.0",
-		"type-fest": "5.6.0"
+		"@markuplint/ml-ast": "5.1.1",
+		"@markuplint/ml-spec": "5.2.0",
+		"@markuplint/shared": "5.2.0",
+		"@markuplint/types": "5.2.0",
+		"debug": "^4.4.3",
+		"espree": "^11.2.0",
+		"type-fest": "^5.10.0"
 	},
 	"devDependencies": {
-		"@typescript-eslint/typescript-estree": "8.59.0"
+		"@typescript-eslint/typescript-estree": "8.71.1"
 	},
-	"gitHead": "3a061784a8211034ad0c1cbd64798c0213414f65"
+	"gitHead": "d8b2feab77c9c862513615bea6b80d2817431878"
 }