npm - @markuplint/html-spec - Versions diffs - 5.0.0-alpha.0 → 5.0.0-alpha.2 - Mend

@markuplint/html-spec 5.0.0-alpha.0 → 5.0.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/ARCHITECTURE.ja.md +17 -13
package/ARCHITECTURE.md +15 -10
package/CHANGELOG.md +12 -0
package/README.md +4 -4
package/docs/build-pipeline.ja.md +8 -5
package/docs/build-pipeline.md +8 -5
package/docs/element-spec-format.ja.md +81 -17
package/docs/element-spec-format.md +44 -6
package/docs/maintenance.ja.md +28 -13
package/docs/maintenance.md +41 -7
package/index.json +1462 -29
package/package.json +5 -5

package/ARCHITECTURE.ja.md CHANGED Viewed

@@ -2,9 +2,9 @@
 ## 概要
-`@markuplint/html-spec` は HTML Living Standard のデータセットプロバイダです。TypeScript ソースコードを含まない純粋なデータパッケージであり、177 個の要素 JSON 仕様ファイルと 2 個の共通定義ファイルから構成されます。
+`@markuplint/html-spec` は HTML Living Standard のデータセットプロバイダです。TypeScript ソースコードを含まない純粋なデータパッケージであり、208 個の要素 JSON 仕様ファイル（HTML、SVG、MathML）と 2 個の共通定義ファイルから構成されます。
-ビルド時に `@markuplint/spec-generator` が外部ソース（MDN、W3C ARIA 1.1/1.2/1.3、HTML Living Standard、SVG 仕様）からデータをフェッチし、手動で管理されたローカル仕様とマージして、統合された `index.json`（48,000 行以上、約 1.4MB）を生成します。手動データは常に外部データより優先され、仕様の正確性を保証します。
+ビルド時に `@markuplint/spec-generator` が外部ソース（MDN、W3C ARIA 1.1/1.2/1.3、HTML Living Standard、SVG 仕様、MathML 仕様）からデータをフェッチし、手動で管理されたローカル仕様とマージして、統合された `index.json`（48,000 行以上、約 1.4MB）を生成します。手動データは常に外部データより優先され、仕様の正確性を保証します。
 ## ディレクトリ構成
@@ -12,10 +12,11 @@
 src/
 ├── spec.a.jsonc                      # <a> 要素の仕様
 ├── spec.abbr.jsonc                   # <abbr> 要素の仕様
-├── ... (計 177 個の要素仕様ファイル)
+├── ... (計 208 個の要素仕様ファイル)
 ├── spec.svg_text.jsonc               # <svg:text> 要素の仕様
-├── spec-common.attributes.jsonc      # 19 個のグローバル属性カテゴリ定義
-└── spec-common.contents.jsonc        # HTML 10 + SVG 19 のコンテンツモデルカテゴリ定義
+├── spec.mml_math.jsonc               # <mml:math> 要素の仕様
+├── spec-common.attributes.jsonc      # 20 個のグローバル属性カテゴリ定義
+└── spec-common.contents.jsonc        # HTML 10 + SVG 19 + MathML 3 のコンテンツモデルカテゴリ定義
 build.mjs                             # @markuplint/spec-generator を呼び出すビルドスクリプト
 index.json                            # 生成出力（48K 行以上、編集不可）
@@ -32,7 +33,7 @@ flowchart TD
     subgraph sources ["ソースデータ"]
         specFiles["src/spec.*.jsonc\n(177 個の要素仕様)"]
         commonAttrs["src/spec-common.attributes.jsonc\n(19 グローバル属性カテゴリ)"]
-        commonContents["src/spec-common.contents.jsonc\n(HTML 10 + SVG 19 コンテンツモデル)"]
+        commonContents["src/spec-common.contents.jsonc\n(HTML 10 + SVG 19 + MathML 3 コンテンツモデル)"]
     end
     subgraph build ["ビルドパイプライン"]
@@ -45,6 +46,7 @@ flowchart TD
         aria["W3C ARIA\n(1.1 / 1.2 / 1.3)"]
         htmlLs["HTML Living Standard"]
         svg["SVG 仕様"]
+        mathml["MathML 仕様"]
     end
     subgraph output ["生成出力"]
@@ -66,6 +68,7 @@ flowchart TD
     aria --> specGen
     htmlLs --> specGen
     svg --> specGen
+    mathml --> specGen
     specGen -->|"手動データ優先で\n外部データとマージ"| indexJson
@@ -86,11 +89,11 @@ flowchart TD
 グローバル定義を格納するオブジェクトです。
-| キー             | 内容                                                                 |
-| ---------------- | -------------------------------------------------------------------- |
-| `#globalAttrs`   | 19 個のグローバル属性カテゴリ（`#HTMLGlobalAttrs` 等）               |
-| `#aria`          | バージョン別 ARIA 定義（1.1, 1.2, 1.3）                              |
-| `#contentModels` | コンテンツモデルカテゴリマクロ（HTML 10 カテゴリ + SVG 19 カテゴリ） |
+| キー             | 内容                                                                   |
+| ---------------- | ---------------------------------------------------------------------- |
+| `#globalAttrs`   | 20 個のグローバル属性カテゴリ（`#HTMLGlobalAttrs` 等）                 |
+| `#aria`          | バージョン別 ARIA 定義（1.1, 1.2, 1.3）                                |
+| `#contentModels` | コンテンツモデルカテゴリマクロ（HTML 10 + SVG 19 + MathML 3 カテゴリ） |
 ### `specs`
@@ -114,7 +117,7 @@ export = json;
 | コンポーネント | ファイル                                | 説明                                                          |
 | -------------- | --------------------------------------- | ------------------------------------------------------------- |
-| ソース仕様     | `src/spec.*.jsonc`（177 ファイル）      | 要素ごとの仕様定義（コンテンツモデル、属性、ARIA マッピング） |
+| ソース仕様     | `src/spec.*.jsonc`（208 ファイル）      | 要素ごとの仕様定義（コンテンツモデル、属性、ARIA マッピング） |
 | 共通定義       | `src/spec-common.*.jsonc`（2 ファイル） | グローバル属性カテゴリとコンテンツモデルマクロの共有定義      |
 | ビルドシステム | `build.mjs`                             | `@markuplint/spec-generator` の `main()` を呼び出すエントリー |
 | 生成出力       | `index.json`                            | 統合データセット（48K 行以上、直接編集不可）                  |
@@ -179,6 +182,7 @@ export = json;
 - **HTML カテゴリ**（10 個）: `#metadata`, `#flow`, `#sectioning`, `#heading`, `#phrasing`, `#embedded`, `#interactive`, `#palpable`, `#scriptSupporting`, `#formAssociated`
 - **SVG カテゴリ**（19 個）: `#SVGAnimation`, `#SVGDescriptive`, `#SVGShape`, `#SVGStructural` 等
+- **MathML カテゴリ**（3 個）: `#MathMLPresentation`, `#MathMLScript`, `#MathMLTabular`
 ## ビルドパイプライン
@@ -199,7 +203,7 @@ await main({
 ビルドプロセスの流れ:
 1. `src/spec.*.jsonc` と `src/spec-common.*.jsonc` を読み込む
-2. MDN、W3C ARIA（1.1/1.2/1.3）、HTML Living Standard、SVG 仕様から外部データをフェッチ
+2. MDN、W3C ARIA（1.1/1.2/1.3）、HTML Living Standard、SVG 仕様、MathML 仕様から外部データをフェッチ
 3. 手動仕様と外部データをマージ（手動データが優先）
 4. 統合された `index.json` を出力

package/ARCHITECTURE.md CHANGED Viewed

@@ -2,9 +2,9 @@
 ## Overview
-`@markuplint/html-spec` is the canonical HTML Living Standard dataset provider for markuplint. It is a pure data package with no TypeScript source code. It contains 177 per-element JSON specification files and 2 common definition files that are processed by `@markuplint/spec-generator` to produce a single consolidated `index.json` (48K+ lines, 1.4MB).
+`@markuplint/html-spec` is the canonical HTML Living Standard dataset provider for markuplint. It is a pure data package with no TypeScript source code. It contains 208 per-element JSON specification files (HTML, SVG, and MathML) and 2 common definition files that are processed by `@markuplint/spec-generator` to produce a single consolidated `index.json` (48K+ lines, 1.4MB).
-During the build, `@markuplint/spec-generator` fetches live data from MDN, W3C ARIA specifications (1.1, 1.2, 1.3), Graphics ARIA, DPub ARIA, HTML-ARIA mappings, the HTML Living Standard, and SVG specifications, then merges that external data with the hand-authored JSON files. Manual specifications always take precedence over fetched data, ensuring stable, curated definitions while still benefiting from automated enrichment.
+During the build, `@markuplint/spec-generator` fetches live data from MDN, W3C ARIA specifications (1.1, 1.2, 1.3), Graphics ARIA, DPub ARIA, HTML-ARIA mappings, the HTML Living Standard, SVG specifications, and MathML specifications, then merges that external data with the hand-authored JSON files. Manual specifications always take precedence over fetched data, ensuring stable, curated definitions while still benefiting from automated enrichment.
 ## Directory Structure
@@ -12,10 +12,11 @@ During the build, `@markuplint/spec-generator` fetches live data from MDN, W3C A
 src/
 ├── spec.a.jsonc                      # <a> element specification
 ├── spec.abbr.jsonc                   # <abbr> element specification
-├── ... (177 element specification files total)
+├── ... (208 element specification files total)
 ├── spec.svg_text.jsonc               # <svg:text> element specification
-├── spec-common.attributes.jsonc      # 19 global attribute category definitions
-└── spec-common.contents.jsonc        # 10 HTML + 19 SVG content model category definitions
+├── spec.mml_math.jsonc               # <mml:math> element specification
+├── spec-common.attributes.jsonc      # 20 global attribute category definitions
+└── spec-common.contents.jsonc        # 10 HTML + 19 SVG + 3 MathML content model category definitions
 build.mjs                             # Build script invoking @markuplint/spec-generator
 index.json                            # Generated output (48K+ lines, DO NOT EDIT)
@@ -32,7 +33,7 @@ flowchart TD
     subgraph sources ["Source Layer"]
         elemSpecs["177 element specs\n(src/spec.*.jsonc)"]
         commonAttrs["spec-common.attributes.jsonc\n(19 global attribute categories)"]
-        commonContents["spec-common.contents.jsonc\n(10 HTML + 19 SVG content models)"]
+        commonContents["spec-common.contents.jsonc\n(10 HTML + 19 SVG + 3 MathML content models)"]
     end
     subgraph build ["Build Pipeline"]
@@ -48,6 +49,7 @@ flowchart TD
         htmlAria["HTML-ARIA Mappings"]
         htmlLS["HTML Living Standard\n(elements, attributes)"]
         svg["SVG Specification\n(elements, attributes)"]
+        mathml["MathML Specification\n(elements, attributes)"]
     end
     subgraph output ["Generated Output"]
@@ -72,6 +74,7 @@ flowchart TD
     htmlAria --> specGen
     htmlLS --> specGen
     svg --> specGen
+    mathml --> specGen
     specGen -->|"merge\n(manual takes precedence)"| indexJson
@@ -94,7 +97,7 @@ Global definitions shared across all element specifications.
 | Key              | Description                                                                                                          |
 | ---------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `#globalAttrs`   | 19 global attribute categories defining attributes available on all or specific groups of elements                   |
+| `#globalAttrs`   | 20 global attribute categories defining attributes available on all or specific groups of elements                   |
 | `#aria`          | ARIA role and property definitions per specification version (1.1, 1.2, 1.3), plus Graphics ARIA and DPub ARIA roles |
 | `#contentModels` | Content model category macros mapping category names to their member elements                                        |
@@ -120,22 +123,24 @@ Global definitions shared across all element specifications.
 | `#SVGFilterPrimitiveAttrs`          | SVG filter primitive attributes       |
 | `#SVGPresentationAttrs`             | SVG presentation attributes           |
 | `#SVGTransferFunctionAttrs`         | SVG transfer function attributes      |
+| `#MathMLGlobalAttrs`                | MathML global attributes              |
 | `#XLinkAttrs`                       | XLink attributes                      |
 **Content Model Categories** (`#contentModels`):
 - **HTML (10):** `#metadata`, `#flow`, `#sectioning`, `#heading`, `#phrasing`, `#embedded`, `#interactive`, `#palpable`, `#script-supporting`, plus one empty placeholder
 - **SVG (19):** `#SVGAnimation`, `#SVGBasicShapes`, `#SVGContainer`, `#SVGDescriptive`, `#SVGFilterPrimitive`, `#SVGFont`, `#SVGGradient`, `#SVGGraphics`, `#SVGGraphicsReferencing`, `#SVGLightSource`, `#SVGNeverRendered`, `#SVGPaintServer`, `#SVGRenderable`, `#SVGShape`, `#SVGStructural`, `#SVGStructurallyExternal`, `#SVGTextContent`, `#SVGTextContentChild`, plus one empty placeholder
+- **MathML (3):** `#MathMLPresentation`, `#MathMLScript`, `#MathMLTabular`
 ### `specs`
-An array of element specifications. Each entry defines a single HTML or SVG element with its content model, permitted attributes, ARIA role mappings, and categorization.
+An array of element specifications. Each entry defines a single HTML, SVG, or MathML element with its content model, permitted attributes, ARIA role mappings, and categorization.
 ## Core Components
 | Component             | Files                                                        | Purpose                                                                        |
 | --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------ |
-| Source Specifications | 177 `src/spec.*.jsonc` files                                 | Per-element definitions: content models, attributes, ARIA mappings             |
+| Source Specifications | 208 `src/spec.*.jsonc` files                                 | Per-element definitions: content models, attributes, ARIA mappings             |
 | Common Definitions    | `spec-common.attributes.jsonc`, `spec-common.contents.jsonc` | Shared global attribute categories and content model category macros           |
 | Build System          | `build.mjs`                                                  | Invokes `@markuplint/spec-generator` to merge sources with external data       |
 | Generated Output      | `index.json`                                                 | Single consolidated dataset consumed by downstream packages                    |
@@ -187,7 +192,7 @@ flowchart LR
 ### Upstream
 - **`@markuplint/ml-spec`** provides the TypeScript type definitions (`MLMLSpec`, `ElementSpec`, `SpecDefs`) and JSON schemas used to validate the generated output. The `index.d.ts` re-exports these types.
-- **`@markuplint/spec-generator`** is the build tool invoked by `build.mjs`. It reads the source JSON files, fetches live data from MDN Web Docs, W3C ARIA specifications (versions 1.1, 1.2, 1.3), Graphics ARIA, DPub ARIA, HTML-ARIA mappings, the HTML Living Standard, and SVG specifications, then merges everything into `index.json`.
+- **`@markuplint/spec-generator`** is the build tool invoked by `build.mjs`. It reads the source JSON files, fetches live data from MDN Web Docs, W3C ARIA specifications (versions 1.1, 1.2, 1.3), Graphics ARIA, DPub ARIA, HTML-ARIA mappings, the HTML Living Standard, SVG specifications, and MathML specifications, then merges everything into `index.json`.
 ### Downstream

package/CHANGELOG.md CHANGED Viewed

@@ -3,6 +3,18 @@
 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.2](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.1...v5.0.0-alpha.2) (2026-02-23)
+### Features
+- **html-spec:** add 32 MathML element specifications ([2acf2e1](https://github.com/markuplint/markuplint/commit/2acf2e1f1c6f536a6de424a6b7eb6c9b9ca2c178))
+# [5.0.0-alpha.1](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.0...v5.0.0-alpha.1) (2026-02-22)
+### Features
+- **html-spec:** add conditional aside role mapping for ARIA 1.3 ([f3315b7](https://github.com/markuplint/markuplint/commit/f3315b7352d17308c8d6edfc0831da3cb33a0922))
 # [5.0.0-alpha.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v5.0.0-alpha.0) (2026-02-20)
 ### Bug Fixes

package/README.md CHANGED Viewed

@@ -35,14 +35,14 @@ Core packages (Application Layer)
 ### Source Files (EDIT THESE)
-- **`src/spec.*.jsonc`** - Individual element specifications (177 files)
-- **`src/spec-common.attributes.jsonc`** - Global attribute category definitions (19 categories)
-- **`src/spec-common.contents.jsonc`** - Content model category macros (HTML 10 + SVG 19 categories)
+- **`src/spec.*.jsonc`** - Individual element specifications (208 files)
+- **`src/spec-common.attributes.jsonc`** - Global attribute category definitions (20 categories)
+- **`src/spec-common.contents.jsonc`** - Content model category macros (HTML 10 + SVG 19 + MathML 3 categories)
 ### Build System
 - **`build.mjs`** - Generation script that invokes `@markuplint/spec-generator`
-- Fetches live data from MDN, W3C ARIA specs, Graphics ARIA, DPub ARIA, HTML-ARIA mappings, HTML Living Standard, and SVG specs
+- Fetches live data from MDN, W3C ARIA specs, Graphics ARIA, DPub ARIA, HTML-ARIA mappings, HTML Living Standard, SVG specs, and MathML specs
 ## Relationship to @markuplint/ml-spec

package/docs/build-pipeline.ja.md CHANGED Viewed

@@ -6,7 +6,7 @@
 `@markuplint/html-spec` は `@markuplint/spec-generator` を使用して、単一の統合 `index.json` ファイルを生成します。ビルドプロセス:
-1. `src/` から 177 個の要素 JSON 仕様ファイルと 2 個の共通定義ファイルを読み込む
+1. `src/` から 208 個の要素 JSON 仕様ファイル（HTML、SVG、MathML）と 2 個の共通定義ファイルを読み込む
 2. MDN Web Docs、W3C ARIA 仕様、HTML Living Standard から外部データをフェッチ
 3. 手動仕様と外部データをマージ（手動データが常に優先）
 4. 統合結果を `index.json` に出力（約 48K 行、約 1.4MB）
@@ -18,8 +18,8 @@
 ```mermaid
 flowchart TD
     subgraph inputs ["ソースファイル（html-spec）"]
-        specFiles["src/spec.*.jsonc\n（177 要素ファイル）"]
-        commonAttrs["src/spec-common.attributes.jsonc\n（19 グローバル属性カテゴリ）"]
+        specFiles["src/spec.*.jsonc\n（208 要素ファイル）"]
+        commonAttrs["src/spec-common.attributes.jsonc\n（20 グローバル属性カテゴリ）"]
         commonContents["src/spec-common.contents.jsonc\n（コンテンツモデルマクロ）"]
     end
@@ -32,6 +32,7 @@ flowchart TD
         mdn["MDN Web Docs"]
         aria["W3C ARIA（1.1 / 1.2 / 1.3）"]
         svg["SVG / Graphics ARIA"]
+        mathml["MathML"]
     end
     subgraph output ["出力"]
@@ -46,6 +47,7 @@ flowchart TD
     mdn --> specGen
     aria --> specGen
     svg --> specGen
+    mathml --> specGen
     specGen -->|"手動データ優先で\nマージ"| indexJson
 ```
@@ -81,6 +83,7 @@ spec-generator はビルド時に以下の外部ソースからデータをフ
 | ----------------------------------------- | ------------------------------------------------------------ |
 | MDN Web Docs（HTML）                      | 要素の説明、コンテンツカテゴリ、属性メタデータ、互換性フラグ |
 | MDN Web Docs（SVG）                       | SVG 要素の説明、非推奨要素リスト                             |
+| MDN Web Docs（MathML）                    | MathML 要素の説明、非推奨要素リスト                          |
 | WAI-ARIA 1.1（`w3.org/TR/wai-aria-1.1/`） | ロール定義、プロパティ、ステート                             |
 | WAI-ARIA 1.2（`w3.org/TR/wai-aria-1.2/`） | 更新されたロール定義                                         |
 | WAI-ARIA 1.3（`w3c.github.io/aria/`）     | 最新の Editor's Draft                                        |
@@ -127,7 +130,7 @@ spec-generator の内部アーキテクチャ（スクレイピング、キャ
 {
   cites: string[];           // フェッチされた全 URL のソート済みリスト
   def: {
-    "#globalAttrs": { ... }, // 19 グローバル属性カテゴリ
+    "#globalAttrs": { ... }, // 20 グローバル属性カテゴリ
     "#aria": {               // バージョン別 ARIA 定義
       "1.1": { roles, props, graphicsRoles },
       "1.2": { roles, props, graphicsRoles },
@@ -135,7 +138,7 @@ spec-generator の内部アーキテクチャ（スクレイピング、キャ
     },
     "#contentModels": { ... } // コンテンツモデルカテゴリマクロ
   },
-  specs: ElementSpec[]       // 要素仕様配列（アルファベット順、SVG は末尾）
+  specs: ElementSpec[]       // 要素仕様配列（アルファベット順、MathML は HTML の後、SVG はその後）
 }
 ```

package/docs/build-pipeline.md CHANGED Viewed

@@ -6,7 +6,7 @@ This document describes how `index.json` is generated from the source files and
 The `@markuplint/html-spec` package uses `@markuplint/spec-generator` to produce a single consolidated `index.json` file. The build process:
-1. Reads 177 per-element JSON spec files and 2 common definition files from `src/`
+1. Reads 208 per-element JSON spec files (HTML, SVG, MathML) and 2 common definition files from `src/`
 2. Fetches external data from MDN Web Docs, W3C ARIA specifications, and the HTML Living Standard
 3. Merges manual specifications with external data (manual data takes precedence)
 4. Writes the consolidated output to `index.json` (~48K lines, ~1.4MB)
@@ -18,8 +18,8 @@ The build is network-dependent because external data is fetched live. Expect sev
 ```mermaid
 flowchart TD
     subgraph inputs ["Source Files (html-spec)"]
-        specFiles["src/spec.*.jsonc\n(177 element files)"]
-        commonAttrs["src/spec-common.attributes.jsonc\n(19 global attribute categories)"]
+        specFiles["src/spec.*.jsonc\n(208 element files)"]
+        commonAttrs["src/spec-common.attributes.jsonc\n(20 global attribute categories)"]
         commonContents["src/spec-common.contents.jsonc\n(content model macros)"]
     end
@@ -32,6 +32,7 @@ flowchart TD
         mdn["MDN Web Docs"]
         aria["W3C ARIA (1.1 / 1.2 / 1.3)"]
         svg["SVG / Graphics ARIA"]
+        mathml["MathML"]
     end
     subgraph output ["Output"]
@@ -46,6 +47,7 @@ flowchart TD
     mdn --> specGen
     aria --> specGen
     svg --> specGen
+    mathml --> specGen
     specGen -->|"merge\n(manual takes precedence)"| indexJson
 ```
@@ -81,6 +83,7 @@ The spec-generator fetches live data from the following sources during the build
 | ---------------------------------------- | --------------------------------------------------------------------------------- |
 | MDN Web Docs (HTML)                      | Element descriptions, content categories, attribute metadata, compatibility flags |
 | MDN Web Docs (SVG)                       | SVG element descriptions and deprecated element list                              |
+| MDN Web Docs (MathML)                    | MathML element descriptions and deprecated element list                           |
 | WAI-ARIA 1.1 (`w3.org/TR/wai-aria-1.1/`) | Role definitions, properties, states                                              |
 | WAI-ARIA 1.2 (`w3.org/TR/wai-aria-1.2/`) | Updated role definitions                                                          |
 | WAI-ARIA 1.3 (`w3c.github.io/aria/`)     | Latest editor's draft                                                             |
@@ -128,7 +131,7 @@ The `index.json` follows the `ExtendedSpec` type from `@markuplint/ml-spec`:
 {
   cites: string[];           // Sorted list of all URLs fetched during generation
   def: {
-    "#globalAttrs": { ... }, // 19 global attribute categories
+    "#globalAttrs": { ... }, // 20 global attribute categories
     "#aria": {               // ARIA definitions per version
       "1.1": { roles, props, graphicsRoles },
       "1.2": { roles, props, graphicsRoles },
@@ -136,7 +139,7 @@ The `index.json` follows the `ExtendedSpec` type from `@markuplint/ml-spec`:
     },
     "#contentModels": { ... } // Content model category macros
   },
-  specs: ElementSpec[]       // Element specifications, sorted alphabetically (SVG after HTML)
+  specs: ElementSpec[]       // Element specifications, sorted alphabetically (MathML after HTML, SVG after MathML)
 }
 ```

package/docs/element-spec-format.ja.md CHANGED Viewed

@@ -31,12 +31,25 @@ spec.svg_path.jsonc     # <svg:path> 要素
 ファイル名のプレフィックス `svg_` から、要素名は `svg:<local>` として推論されます（例: `spec.svg_text.jsonc` は `svg:text` に対応）。
+### MathML 要素
+ファイル名パターン: `src/spec.mml_<local>.jsonc`
+```
+spec.mml_math.jsonc     # <mml:math> 要素
+spec.mml_mfrac.jsonc    # <mml:mfrac> 要素
+spec.mml_mi.jsonc       # <mml:mi> 要素
+spec.mml_mn.jsonc       # <mml:mn> 要素
+```
+ファイル名のプレフィックス `mml_` から、要素名は `mml:<local>` として推論されます（例: `spec.mml_math.jsonc` は `mml:math` に対応）。
 ### 共通定義ファイル
-| ファイル                       | 内容                                               |
-| ------------------------------ | -------------------------------------------------- |
-| `spec-common.attributes.jsonc` | グローバル属性カテゴリ定義（19 カテゴリ）          |
-| `spec-common.contents.jsonc`   | コンテンツモデルカテゴリマクロ（HTML 10 + SVG 19） |
+| ファイル                       | 内容                                                         |
+| ------------------------------ | ------------------------------------------------------------ |
+| `spec-common.attributes.jsonc` | グローバル属性カテゴリ定義（20 カテゴリ）                    |
+| `spec-common.contents.jsonc`   | コンテンツモデルカテゴリマクロ（HTML 9 + SVG 18 + MathML 3） |
 ## 要素仕様の構造
@@ -171,15 +184,16 @@ spec.svg_path.jsonc     # <svg:path> 要素
 コンテンツモデルパターンのセレクタとして使用可能な形式です。
-| セレクタ形式   | 説明                                | 例                                     |
-| -------------- | ----------------------------------- | -------------------------------------- |
-| タグ名         | HTML 要素名                         | `"dt"`, `"dd"`, `"li"`, `"option"`     |
-| カテゴリ参照   | `:model()` 擬似クラスによるカテゴリ | `":model(flow)"`, `":model(phrasing)"` |
-| 否定セレクタ   | `:not()` との組み合わせ             | `":not(:model(interactive), a)"`       |
-| テキストノード | テキストコンテンツ                  | `"#text"`                              |
-| カスタム要素   | カスタム要素のワイルドカード        | `"#custom"`                            |
-| SVG 名前空間   | パイプ記法による名前空間指定        | `"svg\|a"`, `"svg\|circle"`            |
-| 属性セレクタ   | 属性条件付き要素                    | `"a[href]"`, `"link[itemprop]"`        |
+| セレクタ形式    | 説明                                | 例                                     |
+| --------------- | ----------------------------------- | -------------------------------------- |
+| タグ名          | HTML 要素名                         | `"dt"`, `"dd"`, `"li"`, `"option"`     |
+| カテゴリ参照    | `:model()` 擬似クラスによるカテゴリ | `":model(flow)"`, `":model(phrasing)"` |
+| 否定セレクタ    | `:not()` との組み合わせ             | `":not(:model(interactive), a)"`       |
+| テキストノード  | テキストコンテンツ                  | `"#text"`                              |
+| カスタム要素    | カスタム要素のワイルドカード        | `"#custom"`                            |
+| SVG 名前空間    | パイプ記法による名前空間指定        | `"svg\|a"`, `"svg\|circle"`            |
+| MathML 名前空間 | パイプ記法による名前空間指定        | `"mml\|mi"`, `"mml\|mn"`               |
+| 属性セレクタ    | 属性条件付き要素                    | `"a[href]"`, `"link[itemprop]"`        |
 ---
@@ -210,7 +224,7 @@ spec.svg_path.jsonc     # <svg:path> 要素
 }
 ```
-### 利用可能なグローバル属性カテゴリ（19 カテゴリ）
+### 利用可能なグローバル属性カテゴリ（20 カテゴリ）
 #### HTML カテゴリ
@@ -241,6 +255,12 @@ spec.svg_path.jsonc     # <svg:path> 要素
 | `#SVGTransferFunctionAttrs`         | SVG 転送関数属性                                                          |
 | `#XLinkAttrs`                       | XLink 属性（非推奨）                                                      |
+#### MathML カテゴリ
+| カテゴリ             | 説明                                                                       |
+| -------------------- | -------------------------------------------------------------------------- |
+| `#MathMLGlobalAttrs` | MathML グローバル属性（`dir`, `displaystyle`, `mathcolor`, `mathsize` 等） |
 ---
 ## `attributes`
@@ -455,6 +475,11 @@ ARIA（Accessible Rich Internet Applications）統合仕様を定義します。
   "core-aam": true,
   "graphics-aam": true
 }
+// AAM 参照（MathML 要素で使用）
+"permittedRoles": {
+  "mathml-aam": true
+}
 ```
 ### `conditions`
@@ -522,7 +547,7 @@ ARIA 仕様のバージョンごとに異なるマッピングを定義できま
 `spec-common.contents.jsonc` に定義されるカテゴリマクロです。コンテンツモデルパターンのセレクタで `:model(<category>)` の形式で参照されます。
-### HTML カテゴリ（10）
+### HTML カテゴリ（9）
 | カテゴリ             | 説明                                     | 代表的な要素                                                  |
 | -------------------- | ---------------------------------------- | ------------------------------------------------------------- |
@@ -536,7 +561,7 @@ ARIA 仕様のバージョンごとに異なるマッピングを定義できま
 | `#palpable`          | 実質的なコンテンツをレンダリングする要素 | `a`, `div`, `p`, `img`, `table` 等                            |
 | `#script-supporting` | スクリプトサポート要素                   | `script`, `template`                                          |
-### SVG カテゴリ（19）
+### SVG カテゴリ（18）
 | カテゴリ                   | 説明                     | 代表的な要素                                                   |
 | -------------------------- | ------------------------ | -------------------------------------------------------------- |
@@ -559,13 +584,21 @@ ARIA 仕様のバージョンごとに異なるマッピングを定義できま
 | `#SVGTextContent`          | テキストコンテンツ要素   | `svg\|text`, `svg\|textPath`, `svg\|tspan`                     |
 | `#SVGTextContentChild`     | テキストコンテンツ子要素 | `svg\|textPath`, `svg\|tref`, `svg\|tspan`                     |
+### MathML カテゴリ（3）
+| カテゴリ              | 説明                          | 代表的な要素                                                          |
+| --------------------- | ----------------------------- | --------------------------------------------------------------------- |
+| `#MathMLPresentation` | MathML プレゼンテーション要素 | `mml\|mi`, `mml\|mn`, `mml\|mo`, `mml\|mfrac`, `mml\|msqrt`           |
+| `#MathMLScript`       | MathML スクリプト要素         | `mml\|msub`, `mml\|msup`, `mml\|msubsup`, `mml\|munder`, `mml\|mover` |
+| `#MathMLTabular`      | MathML テーブル要素           | `mml\|mtable`, `mml\|mtr`, `mml\|mtd`                                 |
 ---
 ## 共通定義ファイル
 ### `spec-common.attributes.jsonc`
-19 個のグローバル属性カテゴリの定義ファイルです。各カテゴリはキーに `#` プレフィックス付きの名前を持ち、値は属性名から属性定義へのマッピングです。
+20 個のグローバル属性カテゴリの定義ファイルです。各カテゴリはキーに `#` プレフィックス付きの名前を持ち、値は属性名から属性定義へのマッピングです。
 ```jsonc
 {
@@ -856,6 +889,36 @@ ARIA 仕様のバージョンごとに異なるマッピングを定義できま
 }
 ```
+### MathML 要素（`<mml:mfrac>`）
+```jsonc
+// https://w3c.github.io/mathml-core/#fractions-mfrac
+{
+  "contentModel": {
+    "contents": [{ "oneOrMore": ":model(MathMLPresentation)", "max": 2 }],
+  },
+  "globalAttrs": {
+    "#HTMLGlobalAttrs": true,
+    "#GlobalEventAttrs": true,
+    "#ARIAAttrs": true,
+    "#MathMLGlobalAttrs": true,
+  },
+  "attributes": {},
+  "aria": {
+    "implicitRole": false,
+    "permittedRoles": { "mathml-aam": true },
+  },
+}
+```
+MathML 要素は HTML 要素と比較して以下の特徴があります。
+- **コンテンツモデル**: MathML カテゴリ（`:model(MathMLPresentation)` 等）を使用。`max` フィールドで子要素の最大数を制約可能（例: `<mfrac>` は分子と分母の2つのみ）
+- **グローバル属性**: MathML 固有のカテゴリ（`#MathMLGlobalAttrs`）をインクルード
+- **ARIA**: `permittedRoles` で MathML-AAM 参照オブジェクト（`mathml-aam`）を使用
+---
 SVG 要素は HTML 要素と比較して以下の特徴があります。
 - **コンテンツモデル**: SVG カテゴリ（`:model(SVGAnimation)` 等）とパイプ記法による名前空間指定（`svg|a`）を使用
@@ -949,4 +1012,5 @@ SVG 要素は HTML 要素と比較して以下の特徴があります。
 | 条件付き ARIA          | `conditions` オブジェクト    | `<a>` の href 依存ロール      |
 | バージョン固有 ARIA    | `"1.1"`, `"1.2"` キー        | ARIA バージョン間の差異       |
 | SVG 名前空間           | `svg\|` プレフィックス       | SVG 要素のコンテンツモデル    |
+| MathML 名前空間        | `mml\|` プレフィックス       | MathML 要素のコンテンツモデル |
 | カテゴリ参照           | `:model()` 擬似クラス        | コンテンツモデルパターン      |

package/docs/element-spec-format.md CHANGED Viewed

@@ -18,9 +18,15 @@ Pattern: `src/spec.svg_<local>.jsonc` (e.g., `spec.svg_text.jsonc`, `spec.svg_ci
 The local name preserves case (`svg_animateMotion.jsonc`). The element name is inferred
 at runtime as `svg:<local>` (e.g., `svg:text`, `svg:clipPath`).
+### MathML Elements
+Pattern: `src/spec.mml_<local>.jsonc` (e.g., `spec.mml_math.jsonc`, `spec.mml_mfrac.jsonc`)
+The element name is inferred at runtime as `mml:<local>` (e.g., `mml:math`, `mml:mfrac`).
 ### Common Files
-- `spec-common.attributes.jsonc` -- Global attribute category definitions (19 categories)
+- `spec-common.attributes.jsonc` -- Global attribute category definitions (20 categories)
 - `spec-common.contents.jsonc` -- Content model category macros
 ### JSON with Comments
@@ -127,6 +133,7 @@ element inherits its parent's content model, excluding elements matching the sel
 | `"#text"`                              | Text nodes                  |
 | `"#custom"`                            | Custom elements             |
 | `"svg\|a"`, `"svg\|circle"`            | SVG namespace elements      |
+| `"mml\|mi"`, `"mml\|mn"`               | MathML namespace elements   |
 | `"link[itemprop]"`                     | Attribute selectors         |
 ## Global Attributes
@@ -148,7 +155,7 @@ The `globalAttrs` object maps category names (prefixed with `#`) to inclusion ru
 }
 ```
-### Available Categories (19)
+### Available Categories (20)
 | Category                            | Description                                                         |
 | ----------------------------------- | ------------------------------------------------------------------- |
@@ -171,6 +178,7 @@ The `globalAttrs` object maps category names (prefixed with `#`) to inclusion ru
 | `#SVGPresentationAttrs`             | SVG presentation attributes (fill, stroke, transform, etc.)         |
 | `#SVGTransferFunctionAttrs`         | SVG transfer function attributes                                    |
 | `#XLinkAttrs`                       | XLink attributes (deprecated)                                       |
+| `#MathMLGlobalAttrs`                | MathML global attributes (dir, displaystyle, mathcolor, etc.)       |
 ## Element-Specific Attributes
@@ -307,7 +315,7 @@ The `aria` object defines ARIA role and property integration.
 - `true` -- Any role is permitted
 - `false` -- No explicit roles permitted
 - `string[]` -- Specific permitted role names
-- Object with AAM references (SVG): `{ "core-aam": true, "graphics-aam": true }`
+- Object with AAM references (SVG/MathML): `{ "core-aam": true, "graphics-aam": true }` or `{ "mathml-aam": true }`
 Role entries can also be objects: `{ "name": "directory", "deprecated": true }`.
@@ -356,7 +364,7 @@ spec versions. Version overrides can contain their own `conditions` object:
 ### spec-common.attributes.jsonc
-Defines the 19 global attribute categories. Each category maps attribute names to
+Defines the 20 global attribute categories. Each category maps attribute names to
 definitions using the same format described in the attributes section.
 ### spec-common.contents.jsonc
@@ -369,7 +377,7 @@ Defines content model category macros referenced via `:model()`. Structure:
 ### Content Model Categories
-**HTML categories (10):**
+**HTML categories (9):**
 | Category             | Description                                                |
 | -------------------- | ---------------------------------------------------------- |
@@ -383,7 +391,7 @@ Defines content model category macros referenced via `:model()`. Structure:
 | `#palpable`          | Elements that render visible content                       |
 | `#script-supporting` | Script-supporting elements (script, template)              |
-**SVG categories (19):**
+**SVG categories (18):**
 | Category                   | Description                                                       |
 | -------------------------- | ----------------------------------------------------------------- |
@@ -406,6 +414,14 @@ Defines content model category macros referenced via `:model()`. Structure:
 | `#SVGTextContent`          | Text content elements (text, textPath, tspan, etc.)               |
 | `#SVGTextContentChild`     | Text content child elements (textPath, tspan, etc.)               |
+**MathML categories (3):**
+| Category              | Description                                                   |
+| --------------------- | ------------------------------------------------------------- |
+| `#MathMLPresentation` | MathML presentation elements (mi, mn, mo, mfrac, msqrt, etc.) |
+| `#MathMLScript`       | MathML script elements (msub, msup, msubsup, munder, mover)   |
+| `#MathMLTabular`      | MathML tabular elements (mtable, mtr, mtd)                    |
 ## Full Examples
 ### Simple HTML Element -- `<p>`
@@ -519,3 +535,25 @@ Defines content model category macros referenced via `:model()`. Structure:
   }
 }
 ```
+### MathML Element -- `mml:mfrac`
+```json
+// https://w3c.github.io/mathml-core/#fractions-mfrac
+{
+  "contentModel": {
+    "contents": [{ "oneOrMore": ":model(MathMLPresentation)", "max": 2 }]
+  },
+  "globalAttrs": {
+    "#HTMLGlobalAttrs": true,
+    "#GlobalEventAttrs": true,
+    "#ARIAAttrs": true,
+    "#MathMLGlobalAttrs": true
+  },
+  "attributes": {},
+  "aria": {
+    "implicitRole": false,
+    "permittedRoles": { "mathml-aam": true }
+  }
+}
+```