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

package/ARCHITECTURE.ja.md

@@ -46,9 +46,9 @@ flowchart TD
     end
 
     subgraph local ["ローカルデータ"]
-        specFiles["spec.*.json ファイル\n(read-json.ts)"]
-        commonAttrs["spec-common.attributes.json\n(read-json.ts)"]
-        commonContents["spec-common.contents.json\n(read-json.ts)"]
+        specFiles["spec.*.jsonc ファイル\n(read-json.ts)"]
+        commonAttrs["spec-common.attributes.jsonc\n(read-json.ts)"]
+        commonContents["spec-common.contents.jsonc\n(read-json.ts)"]
     end
 
     subgraph output ["出力"]
@@ -121,14 +121,14 @@ export async function main(options: Options): Promise<void>;
 
 ## 外部依存
 
-| パッケージ            | 用途                                                      |
-| --------------------- | --------------------------------------------------------- |
-| `cheerio`             | スクレイピングしたウェブページの HTML 解析と DOM クエリ   |
-| `cli-progress`        | フェッチ操作のターミナルプログレスバー                    |
-| `ajv`                 | JSON スキーマバリデーション（利用可能だが実行時は未使用） |
-| `fast-xml-parser`     | XML パース（利用可能だが現在のモジュールでは未使用）      |
-| `glob`                | `readJsons()` 用のファイル glob パターンマッチング        |
-| `strip-json-comments` | パース前に JSON ファイルからコメントを除去                |
+| パッケージ        | 用途                                                      |
+| ----------------- | --------------------------------------------------------- |
+| `cheerio`         | スクレイピングしたウェブページの HTML 解析と DOM クエリ   |
+| `cli-progress`    | フェッチ操作のターミナルプログレスバー                    |
+| `ajv`             | JSON スキーマバリデーション（利用可能だが実行時は未使用） |
+| `fast-xml-parser` | XML パース（利用可能だが現在のモジュールでは未使用）      |
+| `glob`            | `readJsons()` 用のファイル glob パターンマッチング        |
+| `jsonc-parser`    | JSONC ファイル（コメント付き JSON）のパース               |
 
 **開発依存:**
 

package/ARCHITECTURE.md

@@ -42,13 +42,14 @@ flowchart TD
         mdnSVG["MDN SVG Element Index\n(svg.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)"]
         htmlAria["HTML-ARIA Mapping\n(aria.ts)"]
     end
 
     subgraph local ["Local Data"]
-        specFiles["spec.*.json files\n(read-json.ts)"]
-        commonAttrs["spec-common.attributes.json\n(read-json.ts)"]
-        commonContents["spec-common.contents.json\n(read-json.ts)"]
+        specFiles["spec.*.jsonc files\n(read-json.ts)"]
+        commonAttrs["spec-common.attributes.jsonc\n(read-json.ts)"]
+        commonContents["spec-common.contents.jsonc\n(read-json.ts)"]
     end
 
     subgraph output ["Output"]
@@ -65,6 +66,7 @@ flowchart TD
     getGlobalAttrs --> commonAttrs
     getAria --> ariaSpecs
     getAria --> graphicsAria
+    getAria --> dpubAria
     getAria --> htmlAria
 
     getElements --> extendedSpec
@@ -108,12 +110,12 @@ export async function main(options: Options): Promise<void>;
 1. **Parallel data gathering** -- `main()` launches three tasks concurrently via `Promise.all`:
    - `getElements(htmlFilePattern)` -- reads local spec files, scrapes MDN for each element, appends obsolete elements
    - `getGlobalAttrs(commonAttrsFilePath)` -- reads global attribute definitions
-   - `getAria()` -- scrapes W3C ARIA specs (1.1, 1.2, 1.3) plus Graphics ARIA and HTML-ARIA
+   - `getAria()` -- scrapes W3C ARIA specs (1.1, 1.2, 1.3) plus Graphics ARIA, DPub ARIA, and HTML-ARIA
 
 2. **Assembly** -- The results are combined into an `ExtendedSpec` object:
    - `cites` -- sorted list of all fetched URLs (from `getReferences()`)
    - `def["#globalAttrs"]` -- global attribute categories
-   - `def["#aria"]` -- ARIA roles, properties, and graphics roles per version
+   - `def["#aria"]` -- ARIA roles, properties, graphics roles, and DPub roles per version
    - `def["#contentModels"]` -- content model categories (from `readJson()`)
    - `specs` -- element specification array
 
@@ -121,14 +123,14 @@ export async function main(options: Options): Promise<void>;
 
 ## External Dependencies
 
-| Package               | Purpose                                                  |
-| --------------------- | -------------------------------------------------------- |
-| `cheerio`             | HTML parsing and DOM querying of scraped web pages       |
-| `cli-progress`        | Terminal progress bar for fetch operations               |
-| `ajv`                 | JSON Schema validation (available but unused in runtime) |
-| `fast-xml-parser`     | XML parsing (available but unused in current modules)    |
-| `glob`                | File glob pattern matching for `readJsons()`             |
-| `strip-json-comments` | Remove comments from JSON files before parsing           |
+| Package           | Purpose                                                  |
+| ----------------- | -------------------------------------------------------- |
+| `cheerio`         | HTML parsing and DOM querying of scraped web pages       |
+| `cli-progress`    | Terminal progress bar for fetch operations               |
+| `ajv`             | JSON Schema validation (available but unused in runtime) |
+| `fast-xml-parser` | XML parsing (available but unused in current modules)    |
+| `glob`            | File glob pattern matching for `readJsons()`             |
+| `jsonc-parser`    | Parse JSONC files (JSON with comments) for spec data     |
 
 **Dev dependencies:**
 
@@ -155,7 +157,7 @@ flowchart LR
 
     subgraph external ["External Sources"]
         mdn["MDN Web Docs"]
-        w3c["W3C ARIA / HTML-ARIA"]
+        w3c["W3C ARIA / DPub ARIA / HTML-ARIA"]
     end
 
     mlSpec -->|"types"| pkg

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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.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
+
+# [5.0.0-alpha.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v5.0.0-alpha.0) (2026-02-20)
+
+### Bug Fixes
+
+- resolve additional eslint-plugin-unicorn v63 errors ([e58a72c](https://github.com/markuplint/markuplint/commit/e58a72c17c97bbec522f9513b99777fac6904d64))
+- **spec-generator:** add windowsPathsNoEscape option to glob call ([77189eb](https://github.com/markuplint/markuplint/commit/77189ebaa7511c32e50246a4b70dbe495117b784))
+- **spec-generator:** disable progress bar in CI and run up:gen twice daily ([526044d](https://github.com/markuplint/markuplint/commit/526044d26ed207e0c2a04c266c9491a14c56b3e1))
+
+### Features
+
+- **spec-generator:** scrape DPub ARIA roles from W3C spec ([681abed](https://github.com/markuplint/markuplint/commit/681abed45c1e61facba040fc3535e3e46ea410be))
+
 ## [4.8.2](https://github.com/markuplint/markuplint/compare/@markuplint/spec-generator@4.8.1...@markuplint/spec-generator@4.8.2) (2026-02-10)
 
 ### Bug Fixes

package/README.md

@@ -12,9 +12,9 @@ Called from `packages/@markuplint/html-spec/build.mjs`:
 ```ts
 await main({
   outputFilePath: 'index.json',
-  htmlFilePattern: 'src/spec.*.json',
-  commonAttrsFilePath: 'src/spec-common.attributes.json',
-  commonContentsFilePath: 'src/spec-common.contents.json',
+  htmlFilePattern: 'src/spec.*.jsonc',
+  commonAttrsFilePath: 'src/spec-common.attributes.jsonc',
+  commonContentsFilePath: 'src/spec-common.contents.jsonc',
 });
 ```
 
@@ -25,20 +25,20 @@ You normally don't run this directly; use:
 
 ## What it does
 
-1. **Read element sources** -- Load every `src/spec.*.json` and infer the element name from the filename
+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
 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, and HTML-ARIA
+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`
 
 For detailed architecture and data flow, see [ARCHITECTURE.md](ARCHITECTURE.md).
 
 ## Precedence rules
 
-- Manual data in `src/spec.*.json` overrides MDN-scraped values on conflict.
+- Manual data in `src/spec.*.jsonc` overrides MDN-scraped values on conflict.
 - Attribute objects are merged per name; manual keys win, MDN may fill missing flags.
-- Shared files under `src/spec-common.*.json` are imported as-is.
+- Shared files under `src/spec-common.*.jsonc` are imported as-is.
 
 ## Network and caching
 

package/docs/maintenance.ja.md

@@ -109,6 +109,7 @@ MDN が要素リファレンスページを再構築した場合、`scraping.ts`
      roles: roles14,
      props: await getProps('1.4', roles14),
      graphicsRoles: await getRoles('1.4', true),
+     dpubRoles,
    },
    ```
 4. **パッケージ間連携:** `@markuplint/ml-spec` の `ARIAVersion` 型も `'1.4'` を含むよう更新が必要
@@ -198,10 +199,9 @@ MDN が要素リファレンスページを再構築した場合、`scraping.ts`
 - 依存として記載されているが、現在どのソースモジュールからもインポートされていない
 - 将来の XML パースニーズのために予約されている可能性あり
 
-### strip-json-comments
+### jsonc-parser
 
-- バージョン: 5.0.3
-- `read-json.ts` で JSON 仕様ファイルの `//` および `/* */` コメントをサポートするために使用
+- `read-json.ts` で JSONC ファイル（`//` および `/* */` コメント付き JSON）のパースに使用
 - `html-spec` パッケージは仕様ファイルの先頭に仕様 URL の参照としてコメントを使用
 
 ### cli-progress

package/docs/maintenance.md

@@ -109,6 +109,7 @@ When a new ARIA specification version is published (e.g., 1.4):
      roles: roles14,
      props: await getProps('1.4', roles14),
      graphicsRoles: await getRoles('1.4', true),
+     dpubRoles,
    },
    ```
 4. **Cross-package:** The `ARIAVersion` type in `@markuplint/ml-spec` must also be updated to include `'1.4'`
@@ -198,10 +199,9 @@ To check which roles were extracted from a specific ARIA version:
 - Listed as a dependency but not currently imported by any source module
 - May be reserved for future XML parsing needs
 
-### strip-json-comments
+### jsonc-parser
 
-- Version: 5.0.3
-- Used in `read-json.ts` to support `//` and `/* */` comments in JSON spec files
+- Used in `read-json.ts` to parse JSONC files (JSON with `//` and `/* */` comments)
 - The `html-spec` package uses comments at the top of spec files for spec URL references
 
 ### cli-progress

package/docs/modules.ja.md

@@ -51,7 +51,7 @@ HTML および SVG 要素仕様の完全なリストを構築します。
 
 **フロー:**
 
-1. `readJsons()` で glob パターンにマッチする全仕様ファイルを読み込み。要素名は正規表現 `spec.([\w-]+).json` でファイル名から抽出（例: `spec.a.json` → `a`）
+1. `readJsons()` で glob パターンにマッチする全仕様ファイルを読み込み。要素名は正規表現 `spec.([\w-]+).jsonc` でファイル名から抽出（例: `spec.a.jsonc` → `a`）
 2. `getSVGElementList()` で非推奨 SVG 要素リストを取得
 3. `fetchObsoleteElements()` で既存の仕様にない非推奨要素のスタブを生成
 4. 各要素について MDN URL を構築し、`fetchHTMLElement()` でメタデータをスクレイピング:
@@ -111,13 +111,14 @@ MDN 要素リファレンスページからメタデータをスクレイピン
 
 W3C ARIA 仕様からロールとプロパティの定義をスクレイピングします。URL パターンとセレクタの詳細は[スクレイピング詳細](scraping.ja.md)を参照。
 
-### `getAria(): Promise<Record<ARIAVersion, { roles, props, graphicsRoles }>>`
+### `getAria(): Promise<Record<ARIAVersion, { roles, props, graphicsRoles, dpubRoles }>>`
 
 サポートされている3つのバージョンすべての ARIA データを返します。各バージョンについて:
 
 1. `getRoles(version)` でロールを取得
 2. `getProps(version, roles)` でプロパティ/ステートを取得
 3. `getRoles(version, true)` でグラフィックス ARIA ロールを取得
+4. `getDpubRoles()` で DPub ARIA ロールを取得（1回だけフェッチし、全バージョンで共有）
 
 **実行順序:** バージョンは順次処理されます（1.3 → 1.2 → 1.1）。各バージョン内では、プロパティの前にロールを取得する必要があります（プロパティはロールの `ownedProperties` から検出されるため）。
 
@@ -129,9 +130,12 @@ W3C ARIA 仕様からロールとプロパティの定義をスクレイピン
 | 1.2        | `https://www.w3.org/TR/wai-aria-1.2/` | `https://w3c.github.io/graphics-aria/`     |
 | 1.3        | `https://w3c.github.io/aria/`         | `https://w3c.github.io/graphics-aria/`     |
 
+**DPub ARIA URL:** `https://w3c.github.io/dpub-aria/`（全バージョン共通）
+
 ### プライベート関数
 
 - `getRoles(version, graphicsAria?)` -- `#role_definitions section.role` 要素をスクレイピング。抽出内容: name, description, generalization, owned properties（required/inherited/general）, required context roles, required owned elements, accessible name 設定, children presentational フラグ, prohibited properties。ロールの同義語を処理（`none`/`presentation`, `image`/`img`）
+- `getDpubRoles()` -- DPub ARIA 仕様からデジタル出版ロール（例: `doc-abstract`, `doc-chapter`）をスクレイピング。`getRoles()` と同じ CSS セレクタを使用。41個の DPub ロールは1回だけフェッチされ、全 ARIA バージョンで共有される
 - `getProps(version, roles)` -- 全ロールの `ownedProperties` からプロパティリストを構築し、各プロパティのセクションをスクレイピング: type（property/state）, value type, enum values, default value, global フラグ, 同等の HTML 属性。`aria-checked` と `aria-hidden` の条件付き値オーバーライドを適用
 - `getAriaInHtml()` -- `https://www.w3.org/TR/html-aria/` から HTML 属性と ARIA プロパティのマッピングテーブルをスクレイピング。`contenteditable` はスキップ（祖先の評価が必要なため）
 - `$$(el, selectors)` -- 複数の CSS セレクタを試し、最初の非空マッチを返す
@@ -181,7 +185,7 @@ W3C ARIA 仕様からロールとプロパティの定義をスクレイピン
 
 ### `readJson<T>(filePath: string): T`
 
-単一の JSON ファイルを読み込みます。`strip-json-comments` を使用してパース前に `//` および `/* */` コメントを除去します。パスが絶対パスでない場合はエラーをスローします。
+単一の JSONC ファイルを読み込みます。`jsonc-parser` を使用して `//` および `/* */` コメント付き JSON をパースします。パスが絶対パスでない場合はエラーをスローします。
 
 ### `readJsons<T>(pattern: string, hook?): Promise<T[]>`
 

package/docs/modules.md

@@ -51,7 +51,7 @@ Builds the complete list of HTML and SVG element specifications.
 
 **Flow:**
 
-1. Read all spec files matching the glob pattern via `readJsons()`. Element names are extracted from filenames using the regex `spec.([\w-]+).json` (e.g., `spec.a.json` becomes `a`)
+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()`
 3. Generate stubs for obsolete elements not already present via `fetchObsoleteElements()`
 4. For each element, construct the MDN URL and scrape metadata via `fetchHTMLElement()`:
@@ -111,13 +111,14 @@ Generates minimal spec stubs for obsolete elements not already present in the ex
 
 Scrapes W3C ARIA specifications for role and property definitions. See [Scraping Details](scraping.md) for URL patterns and selectors.
 
-### `getAria(): Promise<Record<ARIAVersion, { roles, props, graphicsRoles }>>`
+### `getAria(): Promise<Record<ARIAVersion, { roles, props, graphicsRoles, dpubRoles }>>`
 
 Returns ARIA data for all three supported versions. For each version:
 
 1. Fetch roles via `getRoles(version)`
 2. Fetch properties/states via `getProps(version, roles)`
 3. Fetch graphics ARIA roles via `getRoles(version, true)`
+4. Fetch DPub ARIA roles via `getDpubRoles()` (fetched once, shared across all versions)
 
 **Execution order:** Versions are processed sequentially (1.3, then 1.2, then 1.1). Within each version, roles must be fetched before properties (properties are discovered from the roles' `ownedProperties`).
 
@@ -129,9 +130,12 @@ Returns ARIA data for all three supported versions. For each version:
 | 1.2     | `https://www.w3.org/TR/wai-aria-1.2/` | `https://w3c.github.io/graphics-aria/`     |
 | 1.3     | `https://w3c.github.io/aria/`         | `https://w3c.github.io/graphics-aria/`     |
 
+**DPub ARIA URL:** `https://w3c.github.io/dpub-aria/` (same for all versions)
+
 ### Private functions
 
 - `getRoles(version, graphicsAria?)` -- Scrapes `#role_definitions section.role` elements. Extracts: name, description, generalization, owned properties (required/inherited/general), required context roles, required owned elements, accessible name settings, children presentational flag, prohibited properties. Handles role synonyms (`none`/`presentation`, `image`/`img`)
+- `getDpubRoles()` -- Scrapes the DPub ARIA specification for Digital Publishing roles (e.g., `doc-abstract`, `doc-chapter`). Uses the same CSS selectors as `getRoles()`. The 41 DPub roles are fetched once and shared across all ARIA versions
 - `getProps(version, roles)` -- Builds a property list from all role `ownedProperties`, then scrapes each property's section for: type (property/state), value type, enum values, default value, global flag, equivalent HTML attributes. Applies conditional value overrides for `aria-checked` and `aria-hidden`
 - `getAriaInHtml()` -- Scrapes `https://www.w3.org/TR/html-aria/` for the HTML attribute to ARIA property mapping table. Skips `contenteditable` (requires ancestor evaluation)
 - `$$(el, selectors)` -- Tries multiple CSS selectors and returns the first non-empty match
@@ -181,7 +185,7 @@ JSON file reading with comment support.
 
 ### `readJson<T>(filePath: string): T`
 
-Reads a single JSON file. Uses `strip-json-comments` to remove `//` and `/* */` comments before parsing. Throws if the path is not absolute.
+Reads a single JSONC file. Uses `jsonc-parser` to parse JSON with `//` and `/* */` comments. Throws if the path is not absolute.
 
 ### `readJsons<T>(pattern: string, hook?): Promise<T[]>`
 

package/docs/scraping.ja.md

@@ -140,23 +140,23 @@ https://developer.mozilla.org/en-US/docs/Web/SVG/Element
 
 各ロールセクションについて:
 
-| データ                           | セレクタ                                             |
-| -------------------------------- | ---------------------------------------------------- |
-| 名前                             | `.role-name[title]`                                  |
-| 説明                             | `.role-description p`（`\n\n` で結合）               |
-| 抽象かどうか                     | `.role-abstract` テキストが "true"                   |
-| 汎化                             | `.role-parent a`                                     |
-| 必須プロパティ                   | `.role-required-properties li`（親にフォールバック） |
-| 継承プロパティ                   | `.role-inherited li`                                 |
-| 所有プロパティ                   | `.role-properties li` または `.role-properties > a`  |
-| 必須コンテキストロール           | `.role-scope li` または `.role-scope a`              |
-| 必須所有要素                     | `.role-mustcontain li` または `.role-mustcontain a`  |
-| アクセシブル名必須               | `.role-namerequired` に "true" を含む                |
-| アクセシブル名（著者から）       | `.role-namefrom` に "author" を含む                  |
-| アクセシブル名（コンテンツから） | `.role-namefrom` に "content" を含む                 |
-| アクセシブル名禁止               | `.role-namefrom` に "prohibited" を含む              |
-| 子の表示                         | `.role-childpresentational` "true"/"false"           |
-| 禁止プロパティ                   | `.role-disallowed li code`                           |
+| データ                             | セレクタ                                             |
+| ---------------------------------- | ---------------------------------------------------- |
+| 名前                               | `.role-name[title]`                                  |
+| 説明                               | `.role-description p`（`\n\n` で結合）               |
+| 抽象かどうか                       | `.role-abstract` テキストが "true"                   |
+| 汎化                               | `.role-parent a`                                     |
+| 必須プロパティ                     | `.role-required-properties li`（親にフォールバック） |
+| 継承プロパティ                     | `.role-inherited li`                                 |
+| 所有プロパティ                     | `.role-properties li` または `.role-properties > a`  |
+| Required Accessibility Parent Role | `.role-scope li` または `.role-scope a`              |
+| Allowed Accessibility Child Roles  | `.role-mustcontain li` または `.role-mustcontain a`  |
+| アクセシブル名必須                 | `.role-namerequired` に "true" を含む                |
+| アクセシブル名（著者から）         | `.role-namefrom` に "author" を含む                  |
+| アクセシブル名（コンテンツから）   | `.role-namefrom` に "content" を含む                 |
+| アクセシブル名禁止                 | `.role-namefrom` に "prohibited" を含む              |
+| 子の表示                           | `.role-childpresentational` "true"/"false"           |
+| 禁止プロパティ                     | `.role-disallowed li code`                           |
 
 **ロール同義語の処理:**
 
@@ -206,6 +206,20 @@ Graphics ARIA ロールは、同じ `getRoles()` 関数に `graphicsAria = true`
 
 ---
 
+## DPub ARIA スクレイピング
+
+**モジュール:** `aria.ts`
+
+DPub ARIA ロール（Digital Publishing WAI-ARIA Module）は `getDpubRoles()` 関数でフェッチされます。
+
+| URL                                |
+| ---------------------------------- |
+| `https://w3c.github.io/dpub-aria/` |
+
+DPub ARIA 仕様は標準 WAI-ARIA 仕様と同じ HTML 構造および CSS セレクタ（`#role_definitions section.role`、`.role-name[title]`、`.role-parent a` など）を使用しています。`getDpubRoles()` 関数は1回だけ呼び出され、41個のロールはすべての ARIA バージョンで共有されます。
+
+---
+
 ## HTML-ARIA マッピング
 
 **モジュール:** `aria.ts`（`getAriaInHtml()`）

package/docs/scraping.md

@@ -140,23 +140,23 @@ https://developer.mozilla.org/en-US/docs/Web/SVG/Element
 
 For each role section:
 
-| Data                         | Selector                                            |
-| ---------------------------- | --------------------------------------------------- |
-| Name                         | `.role-name[title]`                                 |
-| Description                  | `.role-description p` (joined with `\n\n`)          |
-| Is Abstract                  | `.role-abstract` text equals "true"                 |
-| Generalization               | `.role-parent a`                                    |
-| Required Properties          | `.role-required-properties li` (fallback to parent) |
-| Inherited Properties         | `.role-inherited li`                                |
-| Owned Properties             | `.role-properties li` or `.role-properties > a`     |
-| Required Context Role        | `.role-scope li` or `.role-scope a`                 |
-| Required Owned Elements      | `.role-mustcontain li` or `.role-mustcontain a`     |
-| Accessible Name Required     | `.role-namerequired` contains "true"                |
-| Accessible Name From Author  | `.role-namefrom` contains "author"                  |
-| Accessible Name From Content | `.role-namefrom` contains "content"                 |
-| Accessible Name Prohibited   | `.role-namefrom` contains "prohibited"              |
-| Children Presentational      | `.role-childpresentational` "true"/"false"          |
-| Prohibited Properties        | `.role-disallowed li code`                          |
+| Data                               | Selector                                            |
+| ---------------------------------- | --------------------------------------------------- |
+| Name                               | `.role-name[title]`                                 |
+| Description                        | `.role-description p` (joined with `\n\n`)          |
+| Is Abstract                        | `.role-abstract` text equals "true"                 |
+| Generalization                     | `.role-parent a`                                    |
+| Required Properties                | `.role-required-properties li` (fallback to parent) |
+| Inherited Properties               | `.role-inherited li`                                |
+| Owned Properties                   | `.role-properties li` or `.role-properties > a`     |
+| Required Accessibility Parent Role | `.role-scope li` or `.role-scope a`                 |
+| Allowed Accessibility Child Roles  | `.role-mustcontain li` or `.role-mustcontain a`     |
+| Accessible Name Required           | `.role-namerequired` contains "true"                |
+| Accessible Name From Author        | `.role-namefrom` contains "author"                  |
+| Accessible Name From Content       | `.role-namefrom` contains "content"                 |
+| Accessible Name Prohibited         | `.role-namefrom` contains "prohibited"              |
+| Children Presentational            | `.role-childpresentational` "true"/"false"          |
+| Prohibited Properties              | `.role-disallowed li code`                          |
 
 **Role synonym handling:**
 
@@ -206,6 +206,20 @@ The same CSS selectors used for standard ARIA roles apply to Graphics ARIA roles
 
 ---
 
+## DPub ARIA Scraping
+
+**Module:** `aria.ts`
+
+DPub ARIA roles (Digital Publishing WAI-ARIA Module) are fetched using the `getDpubRoles()` function.
+
+| URL                                |
+| ---------------------------------- |
+| `https://w3c.github.io/dpub-aria/` |
+
+The DPub ARIA specification uses the same HTML structure and CSS selectors as the standard WAI-ARIA specification (`#role_definitions section.role`, `.role-name[title]`, `.role-parent a`, etc.). The `getDpubRoles()` function is called once and the 41 roles are shared across all ARIA versions.
+
+---
+
 ## HTML-ARIA Mapping
 
 **Module:** `aria.ts` (`getAriaInHtml()`)

package/lib/aria.d.ts

@@ -10,15 +10,18 @@ export declare function getAria(): Promise<{
         roles: ARIARoleInSchema[];
         props: ARIAProperty[];
         graphicsRoles: ARIARoleInSchema[];
+        dpubRoles: ARIARoleInSchema[];
     };
     '1.2': {
         roles: ARIARoleInSchema[];
         props: ARIAProperty[];
         graphicsRoles: ARIARoleInSchema[];
+        dpubRoles: ARIARoleInSchema[];
     };
     '1.1': {
         roles: ARIARoleInSchema[];
         props: ARIAProperty[];
         graphicsRoles: ARIARoleInSchema[];
+        dpubRoles: ARIARoleInSchema[];
     };
 }>;

package/lib/aria.js

@@ -10,24 +10,94 @@ export async function getAria() {
     const roles13 = await getRoles('1.3');
     const roles12 = await getRoles('1.2');
     const roles11 = await getRoles('1.1');
+    const dpubRoles = await getDpubRoles();
     return {
         '1.3': {
             roles: roles13,
             props: await getProps('1.3', roles13),
             graphicsRoles: await getRoles('1.3', true),
+            dpubRoles,
         },
         '1.2': {
             roles: roles12,
             props: await getProps('1.2', roles12),
             graphicsRoles: await getRoles('1.2', true),
+            dpubRoles,
         },
         '1.1': {
             roles: roles11,
             props: await getProps('1.1', roles11),
             graphicsRoles: await getRoles('1.1', true),
+            dpubRoles,
         },
     };
 }
+const DPUB_ARIA_URL = 'https://w3c.github.io/dpub-aria/';
+/**
+ * Scrapes DPub (Digital Publishing) ARIA role definitions from the W3C specification.
+ * DPub ARIA is a single-version module independent of WAI-ARIA versioning, so the same
+ * roles are shared across all ARIA versions.
+ *
+ * @returns A sorted array of DPub ARIA role schema objects
+ */
+async function getDpubRoles() {
+    const $ = await fetch(DPUB_ARIA_URL);
+    const $roleList = $('#role_definitions section.role');
+    const roles = [];
+    $roleList.each((_, el) => {
+        const $el = $(el);
+        const name = $el.find('.role-name').attr('title')?.trim() ?? '';
+        const description = $el
+            .find('.role-description p')
+            .toArray()
+            .map(p => $(p).text().trim().replaceAll(/\s+/g, ' ').replaceAll(/\t+/g, ''))
+            .join('\n\n');
+        const generalization = $el
+            .find('table.def .role-parent a')
+            .toArray()
+            .map(a => $(a).text().trim());
+        const ownedInheritedProps = $el
+            .find('table.def .role-inherited li')
+            .toArray()
+            .map(li => {
+            const $li = $(li);
+            const $a = $li.find('a');
+            const text = $li.text();
+            const propName = $a.length > 0
+                ? $a
+                    .text()
+                    .replace(/\s*\(\s*state\s*\)\s*/i, '')
+                    .trim()
+                : text.trim();
+            return {
+                name: propName,
+                inherited: true,
+            };
+        });
+        const accessibleNameRequired = !!/true/i.test($el.find('table.def .role-namerequired').text());
+        const accessibleNameFromAuthor = !!/author/i.test($el.find('table.def .role-namefrom').text());
+        const accessibleNameFromContent = !!/content/i.test($el.find('table.def .role-namefrom').text());
+        const accessibleNameProhibited = !!/prohibited/i.test($el.find('table.def .role-namefrom').text());
+        const $childrenPresentational = $el.find('table.def .role-childpresentational').text();
+        const childrenPresentational = /true/i.test($childrenPresentational)
+            ? true
+            : /false/i.test($childrenPresentational)
+                ? false
+                : undefined;
+        roles.push({
+            name,
+            description,
+            generalization,
+            ownedProperties: ownedInheritedProps.toSorted(nameCompare),
+            accessibleNameRequired,
+            accessibleNameFromAuthor,
+            accessibleNameFromContent,
+            accessibleNameProhibited,
+            childrenPresentational,
+        });
+    });
+    return roles.toSorted(nameCompare);
+}
 /**
  * Returns the URL of the WAI-ARIA specification for a given version.
  *
@@ -143,7 +213,7 @@ async function getRoles(version, graphicsAria = false) {
             : /false/i.test($childrenPresentational)
                 ? false
                 : undefined;
-        const ownedProperties = arrayUnique([...ownedRequiredProps, ...ownedInheritedProps, ...ownedProps].sort(nameCompare));
+        const ownedProperties = arrayUnique([...ownedRequiredProps, ...ownedInheritedProps, ...ownedProps].toSorted(nameCompare));
         const prohibitedProperties = $features
             .find('.role-disallowed li code')
             .toArray()
@@ -197,8 +267,7 @@ async function getRoles(version, graphicsAria = false) {
             };
         }
     }
-    roles.sort(nameCompare);
-    return roles;
+    return roles.toSorted(nameCompare);
 }
 /**
  * Scrapes ARIA properties and states from the specification for a given version.
@@ -228,7 +297,7 @@ async function getProps(version, roles) {
         return hash?.slice(1);
     })
         .filter((s) => !!s));
-    const arias = [...ariaNameList].sort().map((name) => {
+    const arias = [...ariaNameList].toSorted().map((name) => {
         const $section = $(`#${name}`);
         const className = $section.attr('class');
         const type = className && /property/i.test(className) ? 'property' : 'state';
@@ -306,8 +375,7 @@ async function getProps(version, roles) {
         }
         return aria;
     });
-    arias.sort(nameCompare);
-    return arias;
+    return arias.toSorted(nameCompare);
 }
 /**
  * Scrapes the W3C HTML-ARIA specification to extract the mapping between
@@ -331,7 +399,7 @@ async function getAriaInHtml() {
         if (!name) {
             continue;
         }
-        const value = _value?.replace(/"|'/g, '').trim() ?? null;
+        const value = _value?.replaceAll(/"|'/g, '').trim() ?? null;
         const data = {
             name: name,
             value: value === '...' ? null : value,

package/lib/fetch.js

@@ -1,5 +1,9 @@
 import * as cheerio from 'cheerio';
 import { Bar, Presets } from 'cli-progress';
+/**
+ * Whether the process is running in a CI environment.
+ */
+const isCI = Boolean(process.env.CI);
 /**
  * In-memory cache mapping URLs to their raw HTML text responses.
  */
@@ -10,10 +14,12 @@ const cache = new Map();
 const domCache = new Map();
 let total = 1;
 let current = 0;
-const bar = new Bar({
-    format: '🔎 Fetch references... {bar} {percentage}% | ETA: {eta}s | {value}/{total} {process}',
-}, Presets.shades_grey);
-bar.start(total, current, { process: '🚀 Started.' });
+const bar = isCI
+    ? null
+    : new Bar({
+        format: '🔎 Fetch references... {bar} {percentage}% | ETA: {eta}s | {value}/{total} {process}',
+    }, Presets.shades_grey);
+bar?.start(total, current, { process: '🚀 Started.' });
 /**
  * Fetches a URL and returns a parsed Cheerio DOM instance.
  * Results are cached so subsequent calls with the same URL avoid re-fetching and re-parsing.
@@ -40,7 +46,7 @@ export async function fetch(url) {
  */
 export async function fetchText(url) {
     total += 1;
-    bar.setTotal(total);
+    bar?.setTotal(total);
     let text;
     if (cache.has(url)) {
         text = cache.get(url);
@@ -57,7 +63,7 @@ export async function fetchText(url) {
         }
     }
     current += 1;
-    bar.update(current, { process: `🔗 ${url.length > 30 ? `${url.slice(0, 15)}...${url.slice(-15)}` : url}` });
+    bar?.update(current, { process: `🔗 ${url.length > 30 ? `${url.slice(0, 15)}...${url.slice(-15)}` : url}` });
     return text;
 }
 /**
@@ -68,7 +74,7 @@ export async function fetchText(url) {
  */
 export function getReferences() {
     current += 1;
-    bar.update(current, { process: '🎉 Finished.' });
-    bar.stop();
-    return [...cache.keys()].sort();
+    bar?.update(current, { process: '🎉 Finished.' });
+    bar?.stop();
+    return [...cache.keys()].toSorted();
 }

package/lib/html-elements.js

@@ -48,7 +48,7 @@ const obsoleteList = [
  */
 export async function getElements(filePattern) {
     let specs = await readJsons(filePattern, (file, body) => {
-        const name = file.replace(/^.+spec\.([\w-]+)\.json$/i, '$1');
+        const name = file.replace(/^.+spec\.([\w-]+)\.jsonc$/i, '$1');
         return {
             // @ts-ignore
             name,
@@ -127,6 +127,6 @@ export async function getElements(filePattern) {
         return spec;
     }));
     return specs
-        .sort(nameCompare)
-        .sort((a, b) => (a.namespace == b.namespace ? 0 : a.namespace === 'http://www.w3.org/2000/svg' ? 1 : -1));
+        .toSorted(nameCompare)
+        .toSorted((a, b) => (a.namespace == b.namespace ? 0 : a.namespace === 'http://www.w3.org/2000/svg' ? 1 : -1));
 }

package/lib/read-json.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { glob } from 'glob';
-import strip from 'strip-json-comments';
+import { parse } from 'jsonc-parser';
 /**
  * Reads and parses a single JSON file (with support for JSON comments) from an absolute file path.
  *
@@ -14,9 +14,8 @@ export function readJson(filePath) {
     if (!path.isAbsolute(filePath)) {
         throw new Error(`The path must be absolute path: ${filePath}`);
     }
-    let json = fs.readFileSync(filePath, { encoding: 'utf8' });
-    json = strip(json);
-    return JSON.parse(json);
+    const json = fs.readFileSync(filePath, { encoding: 'utf8' });
+    return parse(json);
 }
 /**
  * Reads multiple JSON files matching a glob pattern and optionally transforms each result.
@@ -32,7 +31,7 @@ export async function readJsons(pattern, hook = (_, body) => body) {
     if (!path.isAbsolute(pattern)) {
         throw new Error(`The pattern must be absolute path: ${pattern}`);
     }
-    const files = await glob(pattern);
+    const files = await glob(pattern, { windowsPathsNoEscape: true });
     return Promise.all(files.map(file => {
         const json = readJson(file);
         return hook(file, json);

package/lib/utils.js

@@ -26,8 +26,7 @@ export function nameCompare(a, b) {
  */
 export function sortObjectByKey(o) {
     // @ts-ignore
-    const keys = Object.keys(o);
-    keys.sort(nameCompare);
+    const keys = Object.keys(o).toSorted(nameCompare);
     // @ts-ignore
     const newObj = {};
     for (const key of keys) {

package/package.json

@@ -1,10 +1,13 @@
 {
 	"name": "@markuplint/spec-generator",
-	"version": "4.8.2",
+	"version": "5.0.0-alpha.1",
 	"description": "Generates @markuplint/html-spec",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
+	"engines": {
+		"node": ">=22"
+	},
 	"type": "module",
 	"exports": {
 		".": {
@@ -22,18 +25,18 @@
 	},
 	"dependencies": {
 		"@types/cheerio": "1.0.0",
-		"ajv": "8.17.1",
+		"ajv": "8.18.0",
 		"cheerio": "1.2.0",
 		"cli-progress": "3.12.0",
-		"fast-xml-parser": "5.3.5",
-		"glob": "13.0.1",
-		"strip-json-comments": "5.0.3"
+		"fast-xml-parser": "5.3.7",
+		"glob": "13.0.6",
+		"jsonc-parser": "3.3.1"
 	},
 	"devDependencies": {
-		"@markuplint/ml-spec": "4.10.2",
-		"@markuplint/test-tools": "4.5.23",
+		"@markuplint/ml-spec": "5.0.0-alpha.1",
+		"@markuplint/test-tools": "5.0.0-alpha.1",
 		"@types/cli-progress": "3.11.6",
-		"type-fest": "4.41.0"
+		"type-fest": "5.4.4"
 	},
-	"gitHead": "193ee7c1262bbed95424e38efdf1a8e56ff049f4"
+	"gitHead": "78a295e73a097a1ce09c777c06fa21ab68136387"
 }