@markuplint/spec-generator 5.0.0-alpha.1 → 5.0.0-alpha.3

package/ARCHITECTURE.ja.md

@@ -2,7 +2,7 @@
 
 ## 概要
 
-`@markuplint/spec-generator` は、markuplint の拡張仕様 JSON を生成するビルドツールです。W3C および MDN のウェブ標準ドキュメントをスクレイピングし、HTML/SVG 要素仕様、グローバル属性、ARIA ロール・プロパティ、コンテンツモデル定義を集約して、`@markuplint/html-spec` が消費する単一の `index.json` ファイルに出力します。
+`@markuplint/spec-generator` は、markuplint の拡張仕様 JSON を生成するビルドツールです。W3C および MDN のウェブ標準ドキュメントをスクレイピングし、HTML/SVG/MathML 要素仕様、グローバル属性、ARIA ロール・プロパティ、コンテンツモデル定義を集約して、`@markuplint/html-spec` が消費する単一の `index.json` ファイルに出力します。
 
 このパッケージは直接利用するために公開されるものではありません。`@markuplint/html-spec/build.mjs` からのみ呼び出されます。
 
@@ -16,6 +16,7 @@ src/
 ├── aria.ts           — W3C ARIA 仕様のスクレイピング（ロール、プロパティ、ステート）
 ├── global-attrs.ts   — グローバル属性定義の読み込み
 ├── svg.ts            — MDN から SVG 非推奨要素名を取得
+├── mathml.ts         — MDN から MathML 非推奨要素名を取得
 ├── fetch.ts          — HTTP フェッチ（プロセス内キャッシュ＋プログレスバー付き）
 ├── read-json.ts      — コメント除去付き JSON ファイル読み込み＋ glob 対応
 └── utils.ts          — 共有ヘルパー関数（ソート、重複排除、名前解析）
@@ -40,6 +41,7 @@ flowchart TD
     subgraph scraping ["ウェブスクレイピング"]
         mdnHTML["MDN HTML 要素ページ\n(scraping.ts)"]
         mdnSVG["MDN SVG 要素インデックス\n(svg.ts)"]
+        mdnMathML["MDN MathML 要素インデックス\n(mathml.ts)"]
         ariaSpecs["W3C ARIA 1.1 / 1.2 / 1.3\n(aria.ts)"]
         graphicsAria["Graphics ARIA\n(aria.ts)"]
         htmlAria["HTML-ARIA マッピング\n(aria.ts)"]
@@ -62,6 +64,7 @@ flowchart TD
     getElements --> specFiles
     getElements --> mdnHTML
     getElements --> mdnSVG
+    getElements --> mdnMathML
     getGlobalAttrs --> commonAttrs
     getAria --> ariaSpecs
     getAria --> graphicsAria
@@ -84,6 +87,7 @@ flowchart TD
 | `aria.ts`          | `getAria()`                                                                                                           | W3C ARIA 仕様からロール、プロパティ、ステートをスクレイピング        |
 | `global-attrs.ts`  | `getGlobalAttrs()`                                                                                                    | JSON からグローバル属性定義を読み込み                                |
 | `svg.ts`           | `getSVGElementList()`                                                                                                 | MDN から非推奨 SVG 要素名を取得                                      |
+| `mathml.ts`        | `getMathMLElementList()`                                                                                              | MDN から非推奨 MathML 要素名を取得                                   |
 | `fetch.ts`         | `fetch()`, `fetchText()`, `getReferences()`                                                                           | 2層キャッシュとプログレスバー付き HTTP フェッチ                      |
 | `read-json.ts`     | `readJson()`, `readJsons()`                                                                                           | コメント除去と glob マッチング付き JSON 読み込み                     |
 | `utils.ts`         | `nameCompare()`, `sortObjectByKey()`, `arrayUnique()`, `getName()`, `getThisOutline()`, `mergeAttributes()`, `keys()` | 共有ユーティリティ                                                   |

package/ARCHITECTURE.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-`@markuplint/spec-generator` is a build tool that generates the markuplint extended specification JSON. It scrapes W3C and MDN web standards documentation, aggregates HTML/SVG element specs, global attributes, ARIA roles and properties, and content model definitions into a single `index.json` file consumed by `@markuplint/html-spec`.
+`@markuplint/spec-generator` is a build tool that generates the markuplint extended specification JSON. It scrapes W3C and MDN web standards documentation, aggregates HTML/SVG/MathML element specs, global attributes, ARIA roles and properties, and content model definitions into a single `index.json` file consumed by `@markuplint/html-spec`.
 
 This package is not published for direct use. It is invoked exclusively from `@markuplint/html-spec/build.mjs`.
 
@@ -16,6 +16,7 @@ src/
 ├── aria.ts           — W3C ARIA specification scraping (roles, properties, states)
 ├── global-attrs.ts   — Global attribute definition loader
 ├── svg.ts            — SVG deprecated element list fetcher
+├── mathml.ts         — MathML deprecated element list fetcher
 ├── fetch.ts          — HTTP fetch with in-process caching and progress bar
 ├── read-json.ts      — JSON file reader with comment stripping and glob support
 └── utils.ts          — Shared helper functions (sorting, deduplication, name parsing)
@@ -40,6 +41,7 @@ flowchart TD
     subgraph scraping ["Web Scraping"]
         mdnHTML["MDN HTML Element Pages\n(scraping.ts)"]
         mdnSVG["MDN SVG Element Index\n(svg.ts)"]
+        mdnMathML["MDN MathML Element Index\n(mathml.ts)"]
         ariaSpecs["W3C ARIA 1.1 / 1.2 / 1.3\n(aria.ts)"]
         graphicsAria["Graphics ARIA\n(aria.ts)"]
         dpubAria["DPub ARIA\n(aria.ts)"]
@@ -63,6 +65,7 @@ flowchart TD
     getElements --> specFiles
     getElements --> mdnHTML
     getElements --> mdnSVG
+    getElements --> mdnMathML
     getGlobalAttrs --> commonAttrs
     getAria --> ariaSpecs
     getAria --> graphicsAria
@@ -86,6 +89,7 @@ flowchart TD
 | `aria.ts`          | `getAria()`                                                                                                           | Scrapes W3C ARIA specs for roles, properties, states             |
 | `global-attrs.ts`  | `getGlobalAttrs()`                                                                                                    | Reads global attribute definitions from JSON                     |
 | `svg.ts`           | `getSVGElementList()`                                                                                                 | Fetches deprecated SVG element names from MDN                    |
+| `mathml.ts`        | `getMathMLElementList()`                                                                                              | Fetches deprecated MathML element names from MDN                 |
 | `fetch.ts`         | `fetch()`, `fetchText()`, `getReferences()`                                                                           | HTTP fetching with dual-layer cache and progress bar             |
 | `read-json.ts`     | `readJson()`, `readJsons()`                                                                                           | JSON reading with comment stripping and glob matching            |
 | `utils.ts`         | `nameCompare()`, `sortObjectByKey()`, `arrayUnique()`, `getName()`, `getThisOutline()`, `mergeAttributes()`, `keys()` | Shared utilities                                                 |

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-alpha.3](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.2...v5.0.0-alpha.3) (2026-02-26)
+
+**Note:** Version bump only for package @markuplint/spec-generator
+
+# [5.0.0-alpha.2](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.1...v5.0.0-alpha.2) (2026-02-23)
+
+### Features
+
+- **spec-generator:** add MathML element scraping support ([0c56ba4](https://github.com/markuplint/markuplint/commit/0c56ba4c8ca1a2e401da5cfea0f5cf8f9056f737))
+
 # [5.0.0-alpha.1](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.0...v5.0.0-alpha.1) (2026-02-22)
 
 **Note:** Version bump only for package @markuplint/spec-generator

package/README.md

@@ -27,7 +27,7 @@ You normally don't run this directly; use:
 
 1. **Read element sources** -- Load every `src/spec.*.jsonc` and infer the element name from the filename
 2. **Enrich from MDN** -- Fetch MDN element pages for descriptions, categories, and attribute metadata (manual specs take precedence)
-3. **Add obsolete elements** -- Inject HTML obsolete elements and deprecated SVG elements
+3. **Add obsolete elements** -- Inject HTML obsolete elements, deprecated SVG elements, and deprecated MathML elements
 4. **Load shared data** -- Read global attributes and content model definitions
 5. **Build ARIA definitions** -- Scrape WAI-ARIA (1.1/1.2/1.3), Graphics-ARIA, DPub-ARIA, and HTML-ARIA
 6. **Emit Extended Spec JSON** -- Write `{ cites, def, specs }` to `index.json`

package/docs/modules.ja.md

@@ -45,25 +45,26 @@
 
 ## html-elements.ts
 
-HTML および SVG 要素仕様の完全なリストを構築します。
+HTML、SVG、MathML 要素仕様の完全なリストを構築します。
 
 ### `getElements(filePattern: string): Promise<ExtendedElementSpec[]>`
 
 **フロー:**
 
 1. `readJsons()` で glob パターンにマッチする全仕様ファイルを読み込み。要素名は正規表現 `spec.([\w-]+).jsonc` でファイル名から抽出（例: `spec.a.jsonc` → `a`）
-2. `getSVGElementList()` で非推奨 SVG 要素リストを取得
+2. `getSVGElementList()` で非推奨 SVG 要素リストを取得、`getMathMLElementList()` で非推奨 MathML 要素リストを取得
 3. `fetchObsoleteElements()` で既存の仕様にない非推奨要素のスタブを生成
 4. 各要素について MDN URL を構築し、`fetchHTMLElement()` でメタデータをスクレイピング:
    - 見出し要素（`h1`-`h6`）は MDN パス `Heading_Elements` にマッピング
    - SVG 要素は `/Web/SVG/Reference/Element/<name>` パスを使用
+   - MathML 要素は `/Web/MathML/Element/<name>` パスを使用
    - HTML 要素は `/Web/HTML/Reference/Elements/<name>` パスを使用
 5. スクレイピングデータとローカル仕様データをマージ。**ローカル仕様データが優先**:
    - `cite` -- ローカル値があればそちらを使用、なければ MDN URL
    - `description`, `categories`, `omission` -- MDN から
    - `contentModel`, `aria` -- ローカル仕様のみ（スクレイピングされない）
    - `attributes` -- 属性名ごとにマージ; ローカルエントリが MDN エントリをオーバーライド
-6. アルファベット順にソートし、SVG 要素を HTML 要素の後に配置
+6. アルファベット順にソートし、MathML 要素を HTML 要素の後、SVG 要素をその後に配置
 
 ### `obsoleteList`
 
@@ -71,7 +72,24 @@ HTML および SVG 要素仕様の完全なリストを構築します。
 
 `applet`, `acronym`, `bgsound`, `dir`, `frame`, `frameset`, `noframes`, `isindex`, `keygen`, `listing`, `menuitem`, `nextid`, `noembed`, `param`, `plaintext`, `rb`, `rtc`, `strike`, `xmp`, `basefont`, `big`, `blink`, `center`, `font`, `marquee`, `multicol`, `nobr`, `spacer`, `tt`
 
-MDN から取得した非推奨 SVG 要素と組み合わせて、完全な非推奨セットを構成します。
+MDN から取得した非推奨 SVG・MathML 要素と組み合わせて、完全な非推奨セットを構成します。
+
+---
+
+## mathml.ts
+
+### `getMathMLElementList(): Promise<string[]>`
+
+MDN MathML 要素インデックスページ（`https://developer.mozilla.org/en-US/docs/Web/MathML/Element`）をフェッチし、非推奨および非標準の MathML 要素名を抽出します。
+
+**処理:**
+
+1. メインコンテンツ領域内の全 `<td> <code>` 要素を検索
+2. `m` で始まる名前（MathML の命名規則）でフィルタリング
+3. 含まれる `<tr>` の `.icon-deprecated` または `.icon-nonstandard` アイコンクラスを確認
+4. 各名前に `mml_` プレフィックスを付加（例: `maction` → `mml_maction`）
+
+SVG と異なり、MathML には「Obsolete and deprecated elements」の独立セクションはない。要素テーブル内のアイコンでインラインにステータスが表示される。
 
 ---
 
@@ -250,7 +268,8 @@ MDN SVG 要素インデックスページ（`https://developer.mozilla.org/en-US
 
 要素名文字列をパース:
 
-| 入力           | `localName` | `namespace`                    | `ml`     |
-| -------------- | ----------- | ------------------------------ | -------- |
-| `"div"`        | `"div"`     | `undefined`                    | `"HTML"` |
-| `"svg_circle"` | `"circle"`  | `"http://www.w3.org/2000/svg"` | `"SVG"`  |
+| 入力           | `localName` | `namespace`                            | `ml`       |
+| -------------- | ----------- | -------------------------------------- | ---------- |
+| `"div"`        | `"div"`     | `undefined`                            | `"HTML"`   |
+| `"svg_circle"` | `"circle"`  | `"http://www.w3.org/2000/svg"`         | `"SVG"`    |
+| `"mml_math"`   | `"math"`    | `"http://www.w3.org/1998/Math/MathML"` | `"MathML"` |

package/docs/modules.md

@@ -45,25 +45,26 @@ Coordinates three parallel data-gathering tasks, assembles the results into an `
 
 ## html-elements.ts
 
-Builds the complete list of HTML and SVG element specifications.
+Builds the complete list of HTML, SVG, and MathML element specifications.
 
 ### `getElements(filePattern: string): Promise<ExtendedElementSpec[]>`
 
 **Flow:**
 
 1. Read all spec files matching the glob pattern via `readJsons()`. Element names are extracted from filenames using the regex `spec.([\w-]+).jsonc` (e.g., `spec.a.jsonc` becomes `a`)
-2. Fetch the deprecated SVG element list via `getSVGElementList()`
+2. Fetch the deprecated SVG element list via `getSVGElementList()` and MathML element list via `getMathMLElementList()`
 3. Generate stubs for obsolete elements not already present via `fetchObsoleteElements()`
 4. For each element, construct the MDN URL and scrape metadata via `fetchHTMLElement()`:
    - Heading elements (`h1`-`h6`) are mapped to MDN path `Heading_Elements`
    - SVG elements use the path `/Web/SVG/Reference/Element/<name>`
+   - MathML elements use the path `/Web/MathML/Element/<name>`
    - HTML elements use `/Web/HTML/Reference/Elements/<name>`
 5. Merge scraped data with local spec data. **Local spec data takes precedence**:
    - `cite` -- local value wins if present, otherwise MDN URL
    - `description`, `categories`, `omission` -- from MDN
    - `contentModel`, `aria` -- from local spec only (never scraped)
    - `attributes` -- merged per attribute name; local entries override MDN entries
-6. Sort alphabetically, with SVG elements placed after HTML elements
+6. Sort alphabetically, with MathML elements placed after HTML elements and SVG elements after MathML
 
 ### `obsoleteList`
 
@@ -71,7 +72,24 @@ A hardcoded list of 31 non-conforming HTML elements:
 
 `applet`, `acronym`, `bgsound`, `dir`, `frame`, `frameset`, `noframes`, `isindex`, `keygen`, `listing`, `menuitem`, `nextid`, `noembed`, `param`, `plaintext`, `rb`, `rtc`, `strike`, `xmp`, `basefont`, `big`, `blink`, `center`, `font`, `marquee`, `multicol`, `nobr`, `spacer`, `tt`
 
-These are combined with deprecated SVG elements fetched from MDN to form the complete obsolete set.
+These are combined with deprecated SVG and MathML elements fetched from MDN to form the complete obsolete set.
+
+---
+
+## mathml.ts
+
+### `getMathMLElementList(): Promise<string[]>`
+
+Fetches the MDN MathML element index page (`https://developer.mozilla.org/en-US/docs/Web/MathML/Element`) and extracts deprecated and non-standard MathML element names.
+
+**Processing:**
+
+1. Find all `<td> <code>` elements in the main content area
+2. Filter for names starting with `m` (MathML naming convention)
+3. Check the containing `<tr>` for `.icon-deprecated` or `.icon-nonstandard` icon classes
+4. Prefix each name with `mml_` (e.g., `maction` becomes `mml_maction`)
+
+Unlike SVG, MathML does not have a separate "Obsolete and deprecated elements" section. Status is indicated inline with icons in the element table.
 
 ---
 
@@ -250,7 +268,8 @@ Returns `Object.keys()` with a custom type cast.
 
 Parses an element name string:
 
-| Input          | `localName` | `namespace`                    | `ml`     |
-| -------------- | ----------- | ------------------------------ | -------- |
-| `"div"`        | `"div"`     | `undefined`                    | `"HTML"` |
-| `"svg_circle"` | `"circle"`  | `"http://www.w3.org/2000/svg"` | `"SVG"`  |
+| Input          | `localName` | `namespace`                            | `ml`       |
+| -------------- | ----------- | -------------------------------------- | ---------- |
+| `"div"`        | `"div"`     | `undefined`                            | `"HTML"`   |
+| `"svg_circle"` | `"circle"`  | `"http://www.w3.org/2000/svg"`         | `"SVG"`    |
+| `"mml_math"`   | `"math"`    | `"http://www.w3.org/1998/Math/MathML"` | `"MathML"` |

package/docs/scraping.ja.md

@@ -20,6 +20,12 @@ SVG 要素:
 https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/<name>
 ```
 
+MathML 要素:
+
+```
+https://developer.mozilla.org/en-US/docs/Web/MathML/Element/<name>
+```
+
 **特殊ケース:** 見出し要素（`h1`-`h6`）は単一のページにマッピング:
 
 ```
@@ -122,6 +128,27 @@ https://developer.mozilla.org/en-US/docs/Web/SVG/Element
 
 ---
 
+## MDN MathML インデックススクレイピング
+
+**モジュール:** `mathml.ts`
+
+### 対象
+
+```
+https://developer.mozilla.org/en-US/docs/Web/MathML/Element
+```
+
+### 抽出プロセス
+
+1. メインコンテンツ領域内の全 `<td> <code>` 要素を検索
+2. `m` で始まる要素名（MathML の慣例）でフィルタリング
+3. 含まれる `<tr>` の非推奨/非標準アイコンクラス（`.icon-deprecated`, `.icon-nonstandard`）を確認
+4. 各非推奨/非標準要素名に `mml_` プレフィックスを付加（例: `maction` → `mml_maction`）
+
+SVG と異なり、MathML には「Obsolete and deprecated elements」の独立したセクションはない。代わりに、要素テーブル内のアイコンでインラインに非推奨/非標準ステータスが表示される。
+
+---
+
 ## WAI-ARIA スクレイピング
 
 **モジュール:** `aria.ts`

package/docs/scraping.md

@@ -20,6 +20,12 @@ SVG elements:
 https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/<name>
 ```
 
+MathML elements:
+
+```
+https://developer.mozilla.org/en-US/docs/Web/MathML/Element/<name>
+```
+
 **Special case:** Heading elements (`h1`-`h6`) are mapped to a single page:
 
 ```
@@ -122,6 +128,27 @@ https://developer.mozilla.org/en-US/docs/Web/SVG/Element
 
 ---
 
+## MDN MathML Index Scraping
+
+**Module:** `mathml.ts`
+
+### Target
+
+```
+https://developer.mozilla.org/en-US/docs/Web/MathML/Element
+```
+
+### Extraction Process
+
+1. Find all `<td> <code>` elements in the main content area
+2. Filter for element names starting with `m` (MathML convention)
+3. Check the containing `<tr>` for deprecated/non-standard icon classes (`.icon-deprecated`, `.icon-nonstandard`)
+4. Prefix each deprecated/non-standard element name with `mml_` (e.g., `maction` becomes `mml_maction`)
+
+Unlike SVG, MathML does not have a separate "Obsolete and deprecated elements" section. Instead, deprecated/non-standard status is indicated inline with icons in the element table.
+
+---
+
 ## WAI-ARIA Scraping
 
 **Module:** `aria.ts`

package/lib/aria.js

@@ -390,8 +390,9 @@ async function getAriaInHtml() {
     for (const $implicitProp of $implicitProps) {
         const htmlAttrName = $($implicitProp).find('th:nth-of-type(1) a').eq(0).text();
         if (htmlAttrName === 'contenteditable') {
-            // FIXME:
-            // Cannot design yet because the contenteditable attribute is evaluated with ancestors.
+            // FIXME: The contenteditable attribute's ARIA semantics depend on ancestor elements
+            // (an element inherits contenteditable from its parent). Evaluating this requires
+            // cross-element ancestor traversal which is not available during spec generation.
             continue;
         }
         const implicitProp = $($implicitProp).find('td:nth-of-type(1) code').eq(0).text();

package/lib/html-elements.d.ts

@@ -1,8 +1,8 @@
 import type { ExtendedElementSpec } from '@markuplint/ml-spec';
 /**
- * Builds the complete list of HTML and SVG element specifications by reading local JSON spec files,
+ * Builds the complete list of HTML, SVG, and MathML element specifications by reading local JSON spec files,
  * enriching them with data scraped from MDN, and appending obsolete/deprecated elements.
- * Elements are sorted alphabetically with SVG elements placed after HTML elements.
+ * Elements are sorted alphabetically with MathML elements after HTML and SVG elements after MathML.
  *
  * @param filePattern - An absolute glob pattern matching the per-element JSON spec files
  * @returns A sorted array of extended element specification objects

package/lib/html-elements.js

@@ -1,3 +1,4 @@
+import { getMathMLElementList } from './mathml.js';
 import { readJsons } from './read-json.js';
 import { fetchHTMLElement, fetchObsoleteElements } from './scraping.js';
 import { getSVGElementList } from './svg.js';
@@ -39,9 +40,16 @@ const obsoleteList = [
     'tt',
 ];
 /**
- * Builds the complete list of HTML and SVG element specifications by reading local JSON spec files,
+ * Namespace sort order: HTML first, then MathML, then SVG.
+ */
+const namespaceSortOrder = {
+    'http://www.w3.org/2000/svg': 2,
+    'http://www.w3.org/1998/Math/MathML': 1,
+};
+/**
+ * Builds the complete list of HTML, SVG, and MathML element specifications by reading local JSON spec files,
  * enriching them with data scraped from MDN, and appending obsolete/deprecated elements.
- * Elements are sorted alphabetically with SVG elements placed after HTML elements.
+ * Elements are sorted alphabetically with MathML elements after HTML and SVG elements after MathML.
  *
  * @param filePattern - An absolute glob pattern matching the per-element JSON spec files
  * @returns A sorted array of extended element specification objects
@@ -55,23 +63,34 @@ export async function getElements(filePattern) {
             ...body,
         };
     });
-    const deprecatedList = await getSVGElementList();
-    const obsoleteElements = fetchObsoleteElements([...obsoleteList, ...deprecatedList], specs);
+    const [svgDeprecatedList, mathmlDeprecatedList] = await Promise.all([getSVGElementList(), getMathMLElementList()]);
+    const obsoleteElements = fetchObsoleteElements([...obsoleteList, ...svgDeprecatedList, ...mathmlDeprecatedList], specs);
     specs.push(...obsoleteElements);
     specs = await Promise.all(specs.map(async (el) => {
         const { localName, namespace, ml } = getName(el.name);
         const urlTagName = /^h[1-6]$/i.test(localName) ? 'Heading_Elements' : localName;
         // https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a
         // https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/a
+        // https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element/math
         const cite = `https://developer.mozilla.org/en-US/docs/Web/${ml}/Reference/Element${ml === 'HTML' ? 's' : ''}/${urlTagName}`;
         const mdnData = await fetchHTMLElement(cite);
         // @ts-ignore
         delete el.name;
         // @ts-ignore
         delete el.namespace;
+        let qualifiedName;
+        if (namespace === 'http://www.w3.org/2000/svg') {
+            qualifiedName = `svg:${localName}`;
+        }
+        else if (namespace === 'http://www.w3.org/1998/Math/MathML') {
+            qualifiedName = `mml:${localName}`;
+        }
+        else {
+            qualifiedName = localName;
+        }
         const spec = {
             // @ts-ignore
-            name: namespace === 'http://www.w3.org/2000/svg' ? `svg:${localName}` : localName,
+            name: qualifiedName,
             namespace,
             cite: el.cite ?? mdnData.cite,
             description: mdnData.description,
@@ -126,7 +145,9 @@ export async function getElements(filePattern) {
         };
         return spec;
     }));
-    return specs
-        .toSorted(nameCompare)
-        .toSorted((a, b) => (a.namespace == b.namespace ? 0 : a.namespace === 'http://www.w3.org/2000/svg' ? 1 : -1));
+    return specs.toSorted(nameCompare).toSorted((a, b) => {
+        const orderA = namespaceSortOrder[a.namespace ?? ''] ?? 0;
+        const orderB = namespaceSortOrder[b.namespace ?? ''] ?? 0;
+        return orderA - orderB;
+    });
 }

package/lib/mathml.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Fetches the MDN MathML element index page and extracts the list of
+ * deprecated and non-standard MathML element names.
+ * Each name is prefixed with `"mml_"` to distinguish it from HTML/SVG elements.
+ *
+ * @returns An array of deprecated/non-standard MathML element names (e.g., `["mml_maction", ...]`)
+ */
+export declare function getMathMLElementList(): Promise<string[]>;

package/lib/mathml.js

@@ -0,0 +1,29 @@
+import { fetch } from './fetch.js';
+/**
+ * Fetches the MDN MathML element index page and extracts the list of
+ * deprecated and non-standard MathML element names.
+ * Each name is prefixed with `"mml_"` to distinguish it from HTML/SVG elements.
+ *
+ * @returns An array of deprecated/non-standard MathML element names (e.g., `["mml_maction", ...]`)
+ */
+export async function getMathMLElementList() {
+    const index = 'https://developer.mozilla.org/en-US/docs/Web/MathML/Element';
+    const $ = await fetch(index);
+    const deprecatedList = [];
+    // MathML element page lists deprecated/non-standard status inline with icons
+    // rather than having a separate section like SVG
+    $('main#content td code').each((_, el) => {
+        const $el = $(el);
+        const text = $el.text().trim().replaceAll(/<|>/g, '');
+        if (!text || !text.startsWith('m')) {
+            return;
+        }
+        const $row = $el.closest('tr');
+        const hasDeprecated = $row.find('.icon.icon-deprecated, .icon-deprecated').length > 0;
+        const hasNonStandard = $row.find('.icon.icon-nonstandard, .icon-nonstandard').length > 0;
+        if (hasDeprecated || hasNonStandard) {
+            deprecatedList.push('mml_' + text);
+        }
+    });
+    return deprecatedList;
+}

package/lib/utils.d.ts

@@ -14,7 +14,7 @@ type HasName = {
  * @param b - The second item to compare, either a string or an object with a `name` property
  * @returns A negative number if `a` comes before `b`, positive if after, or zero if equal
  */
-export declare function nameCompare(a: HasName | string, b: HasName | string): 1 | 0 | -1;
+export declare function nameCompare(a: HasName | string, b: HasName | string): 1 | -1 | 0;
 /**
  * Creates a new object with the same key-value pairs, sorted alphabetically by key.
  *
@@ -63,14 +63,15 @@ export declare function mergeAttributes<T>(fromDocs: T, fromJSON: T): T;
 export declare function keys<T, K = keyof T>(object: T): K[];
 /**
  * Parses an element name string to extract the local name, namespace, and markup language type.
- * Handles SVG-prefixed names (e.g., `"svg_circle"`) and plain HTML names.
+ * Handles SVG-prefixed names (e.g., `"svg_circle"`), MathML-prefixed names (e.g., `"mml_math"`),
+ * and plain HTML names.
  *
- * @param origin - The raw element name, optionally prefixed with `"svg_"` for SVG elements
- * @returns An object containing the `localName`, optional SVG `namespace` URI, and `ml` type (`"SVG"` or `"HTML"`)
+ * @param origin - The raw element name, optionally prefixed with `"svg_"` or `"mml_"` for SVG/MathML elements
+ * @returns An object containing the `localName`, optional `namespace` URI, and `ml` type (`"SVG"`, `"MathML"`, or `"HTML"`)
  */
 export declare function getName(origin: string): {
     localName: string;
-    namespace: "http://www.w3.org/2000/svg" | undefined;
+    namespace: "http://www.w3.org/2000/svg" | "http://www.w3.org/1998/Math/MathML" | undefined;
     ml: string;
 };
 export {};

package/lib/utils.js

@@ -109,16 +109,18 @@ export function keys(object) {
 }
 /**
  * Parses an element name string to extract the local name, namespace, and markup language type.
- * Handles SVG-prefixed names (e.g., `"svg_circle"`) and plain HTML names.
+ * Handles SVG-prefixed names (e.g., `"svg_circle"`), MathML-prefixed names (e.g., `"mml_math"`),
+ * and plain HTML names.
  *
- * @param origin - The raw element name, optionally prefixed with `"svg_"` for SVG elements
- * @returns An object containing the `localName`, optional SVG `namespace` URI, and `ml` type (`"SVG"` or `"HTML"`)
+ * @param origin - The raw element name, optionally prefixed with `"svg_"` or `"mml_"` for SVG/MathML elements
+ * @returns An object containing the `localName`, optional `namespace` URI, and `ml` type (`"SVG"`, `"MathML"`, or `"HTML"`)
  */
 export function getName(origin) {
-    const [, ns, localName] = origin.match(/^(?:(svg)_)?(\w+)/i) ?? [];
+    const [, rawNs, localName] = origin.match(/^(?:(svg|mml)_)?([\w-]+)/i) ?? [];
+    const ns = rawNs?.toLowerCase();
     const name = localName ?? origin;
-    const ml = ns === 'svg' ? 'SVG' : 'HTML';
-    const namespace = ns === 'svg' ? 'http://www.w3.org/2000/svg' : undefined;
+    const ml = ns === 'svg' ? 'SVG' : ns === 'mml' ? 'MathML' : 'HTML';
+    const namespace = ns === 'svg' ? 'http://www.w3.org/2000/svg' : ns === 'mml' ? 'http://www.w3.org/1998/Math/MathML' : undefined;
     return {
         localName: name,
         namespace,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/spec-generator",
-	"version": "5.0.0-alpha.1",
+	"version": "5.0.0-alpha.3",
 	"description": "Generates @markuplint/html-spec",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -28,15 +28,15 @@
 		"ajv": "8.18.0",
 		"cheerio": "1.2.0",
 		"cli-progress": "3.12.0",
-		"fast-xml-parser": "5.3.7",
+		"fast-xml-parser": "5.4.1",
 		"glob": "13.0.6",
 		"jsonc-parser": "3.3.1"
 	},
 	"devDependencies": {
-		"@markuplint/ml-spec": "5.0.0-alpha.1",
-		"@markuplint/test-tools": "5.0.0-alpha.1",
+		"@markuplint/ml-spec": "5.0.0-alpha.3",
+		"@markuplint/test-tools": "5.0.0-alpha.3",
 		"@types/cli-progress": "3.11.6",
 		"type-fest": "5.4.4"
 	},
-	"gitHead": "78a295e73a097a1ce09c777c06fa21ab68136387"
+	"gitHead": "2fbdf26daa3d021ac628ccc2f59f0eeae6ddd53d"
 }