@markuplint/ml-spec 5.0.0-alpha.0 → 5.0.0-alpha.1

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)
+
+### Bug Fixes
+
+- **ml-spec:** add transparent traversal fallback in collectLabelText ([d6096c1](https://github.com/markuplint/markuplint/commit/d6096c1ceba190e7799974d0c682695946f852ed))
+
+- feat(ml-spec)!: update default ARIA version to 1.3 ([c3b56e2](https://github.com/markuplint/markuplint/commit/c3b56e2bf06a667a00aa621f2f51a082a90d4e2f))
+
+### BREAKING CHANGES
+
+- The default ARIA specification version used when none
+  is explicitly configured changes from 1.2 to 1.3. This may produce
+  different lint results for rules that depend on ARIA version.
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
 # [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/docs/spec-resolution.ja.md

@@ -155,21 +155,28 @@ result.directivePatterns = [...(result.directivePatterns ?? []), ...extendedSpec
 （最初のマッチが優先）。そのため、フレームワーク spec はパターンを
 最も具体的なものから最も一般的なものの順で定義する必要があります。
 
-#### 6. `useIDLAttributeNames`
+#### 6. `acceptedAttrNames`
 
-拡張仕様が `useIDLAttributeNames` を明示的に設定している場合（`true` または
-`false`）、現在の値を上書きします：
+拡張仕様が `acceptedAttrNames` を明示的に設定している場合、
+現在の値を上書きします：
 
 ```ts
-if (extendedSpec.useIDLAttributeNames != null) {
-  result.useIDLAttributeNames = extendedSpec.useIDLAttributeNames;
+if (extendedSpec.acceptedAttrNames != null) {
+  result.acceptedAttrNames = extendedSpec.acceptedAttrNames;
 }
 ```
 
 これは明示的な `null` ガード付きの last-write-wins セマンティクスです。
 プロパティを省略しても以前に設定された値はリセットされません。
-このフラグは `@markuplint/ml-core` の `MLAttr` コンストラクタで使用され、
-IDL-コンテンツ属性名解決（例: `className` → `class`）を有効化します。
+この値は `@markuplint/ml-core` の `MLAttr` コンストラクタで使用され、
+属性名の解決方法を制御します：
+
+- `'idl'` -- IDL-コンテンツ属性名解決を有効化（例: `className` → `class`）し、
+  コンテンツ属性名が使用された場合にIDL名を候補として提案します
+  （例: `tabindex` → 「`tabIndex` の間違いでは？」）。Reactで使用されます。
+- `'both'` -- IDL-コンテンツ属性名解決を有効化しますが、IDL名を候補として
+  提案**しません**。コンテンツ属性名（例: `class`）とIDLプロパティ名
+  （例: `className`）の両方が警告なしで受け入れられます。Svelteで使用されます。
 
 #### 7. 要素仕様
 

package/docs/spec-resolution.md

@@ -160,21 +160,29 @@ This is simple array concatenation. The core engine evaluates patterns in order
 (first match wins), so framework specs should define their patterns from most
 specific to most general.
 
-#### 6. `useIDLAttributeNames`
+#### 6. `acceptedAttrNames`
 
-If the extended spec explicitly sets `useIDLAttributeNames` (to `true` or
-`false`), it overrides the current value:
+If the extended spec explicitly sets `acceptedAttrNames`, it overrides the
+current value:
 
 ```ts
-if (extendedSpec.useIDLAttributeNames != null) {
-  result.useIDLAttributeNames = extendedSpec.useIDLAttributeNames;
+if (extendedSpec.acceptedAttrNames != null) {
+  result.acceptedAttrNames = extendedSpec.acceptedAttrNames;
 }
 ```
 
 This is a last-write-wins semantic with explicit `null` guard -- omitting the
-property does not reset a previously set value. This flag is consumed by
-`@markuplint/ml-core`'s `MLAttr` constructor to enable IDL-to-content attribute
-name resolution (e.g., `className` -> `class`).
+property does not reset a previously set value. The value controls how
+`@markuplint/ml-core`'s `MLAttr` constructor resolves attribute names:
+
+- `'idl'` -- Enables IDL-to-content attribute name resolution (e.g.,
+  `className` -> `class`) and suggests IDL names as candidates when the
+  content attribute name is used (e.g., `tabindex` -> "Did you mean
+  `tabIndex`?"). Used by React, where only IDL property names are accepted.
+- `'both'` -- Enables IDL-to-content attribute name resolution but does
+  **not** suggest IDL names as candidates. Both content attribute names
+  (e.g., `class`) and IDL property names (e.g., `className`) are accepted
+  without warnings. Used by Svelte.
 
 #### 7. Element Specs
 

package/lib/algorithm/aria/accname/label-steps.js

@@ -59,7 +59,15 @@ function collectLabelText(label, labeledElement, resolver, visited, computeFn, i
                 continue;
             }
             const result = computeFn(childEl, resolver, inLabelledbyTraversal, visited);
-            parts.push(result.name);
+            if (result.name) {
+                parts.push(result.name);
+            }
+            else {
+                // Transparent traversal: when the child element has no accessible name
+                // (e.g., <span> with role="generic"), recursively collect its descendant text.
+                // This matches the behavior of resolveNameFromContent's fallback.
+                parts.push(collectLabelText(childEl, labeledElement, resolver, visited, computeFn, inLabelledbyTraversal));
+            }
         }
     }
     return parts.join(' ');

package/lib/types/aria.d.ts

@@ -91,7 +91,7 @@ export interface ARIA {
         namingProhibited?: true;
         implicitProperties?: ImplicitProperties;
         properties?: PermittedARIAProperties;
-        conditions?: {
+        conditions?: false | {
             /**
              * This interface was referenced by `undefined`'s JSON-Schema definition
              * via the `patternProperty` ".+".
@@ -111,7 +111,7 @@ export interface ARIA {
         namingProhibited?: true;
         implicitProperties?: ImplicitProperties;
         properties?: PermittedARIAProperties;
-        conditions?: {
+        conditions?: false | {
             /**
              * This interface was referenced by `undefined`'s JSON-Schema definition
              * via the `patternProperty` ".+".
@@ -130,7 +130,7 @@ export interface ARIA {
         permittedRoles?: PermittedRoles;
         implicitProperties?: ImplicitProperties;
         properties?: PermittedARIAProperties;
-        conditions?: {
+        conditions?: false | {
             /**
              * This interface was referenced by `undefined`'s JSON-Schema definition
              * via the `patternProperty` ".+".

package/lib/types/index.d.ts

@@ -12,7 +12,7 @@ export interface MLMLSpec {
     readonly def: SpecDefs;
     readonly specs: readonly ElementSpec[];
     readonly directivePatterns?: readonly DirectivePattern[];
-    readonly useIDLAttributeNames?: boolean;
+    readonly acceptedAttrNames?: 'idl' | 'both';
 }
 /**
  * An element specification for extending or overriding parts of the base spec.
@@ -32,7 +32,7 @@ export type ExtendedSpec = {
     readonly def?: Partial<SpecDefs>;
     readonly specs?: readonly ExtendedElementSpec[];
     readonly directivePatterns?: readonly DirectivePattern[];
-    readonly useIDLAttributeNames?: boolean;
+    readonly acceptedAttrNames?: 'idl' | 'both';
 };
 /**
  * A declarative pattern for resolving framework-specific directive

package/lib/utils/aria-version.d.ts

@@ -5,4 +5,4 @@ export declare const ariaVersions: readonly ["1.1", "1.2", "1.3"];
 /**
  * The recommended default ARIA specification version to use when none is explicitly specified.
  */
-export declare const ARIA_RECOMMENDED_VERSION = "1.2";
+export declare const ARIA_RECOMMENDED_VERSION = "1.3";

package/lib/utils/aria-version.js

@@ -5,4 +5,4 @@ export const ariaVersions = ['1.1', '1.2', '1.3'];
 /**
  * The recommended default ARIA specification version to use when none is explicitly specified.
  */
-export const ARIA_RECOMMENDED_VERSION = '1.2';
+export const ARIA_RECOMMENDED_VERSION = '1.3';

package/lib/utils/resolve-version.js

@@ -15,7 +15,8 @@ export function resolveVersion(aria, version) {
     const implicitProperties = aria[version]?.implicitProperties ?? aria.implicitProperties;
     const properties = aria[version]?.properties ?? aria.properties;
     const namingProhibited = version === '1.1' ? aria.namingProhibited : (aria[version]?.namingProhibited ?? aria.namingProhibited);
-    const conditions = aria[version]?.conditions ?? aria.conditions;
+    const versionConditions = aria[version]?.conditions;
+    const conditions = versionConditions === false ? undefined : (versionConditions ?? aria.conditions);
     return {
         implicitRole,
         permittedRoles,

package/lib/utils/schema-to-spec.d.ts

@@ -14,5 +14,5 @@ export declare function schemaToSpec(schemas: readonly [MLMLSpec, ...ExtendedSpe
     def: import("../types/index.js").SpecDefs;
     specs: readonly ElementSpec[];
     directivePatterns?: readonly import("../types/index.js").DirectivePattern[];
-    useIDLAttributeNames?: boolean;
+    acceptedAttrNames?: "idl" | "both";
 };

package/lib/utils/schema-to-spec.js

@@ -68,8 +68,8 @@ export function schemaToSpec(schemas) {
         if (extendedSpec.directivePatterns) {
             result.directivePatterns = [...(result.directivePatterns ?? []), ...extendedSpec.directivePatterns];
         }
-        if (extendedSpec.useIDLAttributeNames != null) {
-            result.useIDLAttributeNames = extendedSpec.useIDLAttributeNames;
+        if (extendedSpec.acceptedAttrNames != null) {
+            result.acceptedAttrNames = extendedSpec.acceptedAttrNames;
         }
         if (extendedSpec.specs) {
             const exSpecs = [...extendedSpec.specs];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/ml-spec",
-	"version": "5.0.0-alpha.0",
+	"version": "5.0.0-alpha.1",
 	"description": "Types and schema that specs of the Markup languages for markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
@@ -34,14 +34,14 @@
 		"schema:prettier": "npx prettier --write \"./schemas/*.json\" \"./src/types/*.ts\" --log-level warn"
 	},
 	"dependencies": {
-		"@markuplint/ml-ast": "5.0.0-alpha.0",
-		"@markuplint/types": "5.0.0-alpha.0",
+		"@markuplint/ml-ast": "5.0.0-alpha.1",
+		"@markuplint/types": "5.0.0-alpha.1",
 		"is-plain-object": "5.0.0",
 		"type-fest": "5.4.4"
 	},
 	"devDependencies": {
-		"@markuplint/test-tools": "5.0.0-alpha.0",
+		"@markuplint/test-tools": "5.0.0-alpha.1",
 		"json-schema-to-typescript": "15.0.4"
 	},
-	"gitHead": "13dcfc84ec83d87360c720e253383b60767e1b56"
+	"gitHead": "78a295e73a097a1ce09c777c06fa21ab68136387"
 }