@markuplint/ml-spec 4.9.6 → 4.10.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.10.0](https://github.com/markuplint/markuplint/compare/@markuplint/ml-spec@4.9.7...@markuplint/ml-spec@4.10.0) (2025-08-24)
+
+
+### Features
+
+* **types:** add link type definitions for specific HTML elements ([7199a8e](https://github.com/markuplint/markuplint/commit/7199a8eb4eaf334855ba78064c4340e040d8614c))
+
+
+
+
+
+## [4.9.7](https://github.com/markuplint/markuplint/compare/@markuplint/ml-spec@4.9.6...@markuplint/ml-spec@4.9.7) (2025-08-13)
+
+### Bug Fixes
+
+- ensure that each `clean` command correctly removes build files ([110b78e](https://github.com/markuplint/markuplint/commit/110b78e85379d29a84ca68325127344a87a570b6))
+
 ## [4.9.6](https://github.com/markuplint/markuplint/compare/@markuplint/ml-spec@4.9.5...@markuplint/ml-spec@4.9.6) (2025-04-13)
 
 **Note:** Version bump only for package @markuplint/ml-spec

package/README.md

@@ -2,17 +2,320 @@
 
 [![npm version](https://badge.fury.io/js/%40markuplint%2Fml-spec.svg)](https://www.npmjs.com/package/@markuplint/ml-spec)
 
-## Install
+**Foundation package providing type definitions, W3C specification algorithms, and unified API for markup language specifications.**
 
-[`markuplint`](https://www.npmjs.com/package/markuplint) package includes this package.
+This package serves as the foundational layer for markuplint's specification system, providing:
 
-<details>
-<summary>If you are installing purposely, how below:</summary>
+- **Type definitions** for markup language specifications (HTML, ARIA, SVG)
+- **W3C specification algorithms** (HTML Standard, WAI-ARIA 1.1/1.2/1.3 compliance)
+- **JSON schemas** that define the structure of element specifications
+- **Runtime utilities** for specification resolution, attribute validation, and content model checking
+- **Unified API** for consuming specification data from various sources
 
-```shell
-$ npm install @markuplint/ml-spec
+The canonical HTML element specification data is provided by `@markuplint/html-spec`, which depends on this package for type definitions and algorithmic processing.
 
-$ yarn add @markuplint/ml-spec
+## Package Architecture
+
+This package serves as the foundation layer in markuplint's specification system:
+
+```
+@markuplint/ml-spec (Foundation Layer)
+  ↓ provides types, algorithms, schemas
+@markuplint/html-spec (Data Layer)
+  ↓ provides HTML specification data
+Framework-specific specs (Extension Layer)
+  ↓ provide framework extensions
+Core packages (Application Layer)
+  ↓ consume specifications for validation
+```
+
+## Package Contents
+
+### Type Definitions
+
+- **Core Types**: `ElementSpec`, `ExtendedSpec`, `MLMLSpec`, `ARIAVersion`
+- **ARIA Types**: Complete WAI-ARIA 1.1/1.2/1.3 type definitions
+- **Attribute Types**: HTML attribute definitions with validation rules
+- **Content Model Types**: Permitted content structure definitions
+
+Generated TypeScript types (do not edit directly):
+
+- `src/types/attributes.ts` - Attribute specification types
+- `src/types/aria.ts` - ARIA specification types
+- `src/types/permitted-structures.ts` - Content model types
+
+### W3C Specification Algorithms
+
+**HTML Standard Algorithms**:
+
+- Focusable Area Algorithm (`src/algorithm/html/may-be-focusable.ts`)
+- Interactive Content classification
+- Content Model validation (`src/algorithm/html/get-content-model.ts`)
+
+**WAI-ARIA Specification Algorithms**:
+
+- **Accessible Name Computation** - W3C AccName 1.1 compliant (via `dom-accessibility-api`)
+- **Role Computation** - Explicit/implicit role resolution with conflict handling (`src/algorithm/aria/get-computed-role.ts`)
+- **Accessibility Tree Computation** - Element inclusion/exclusion logic (`src/algorithm/aria/is-exposed.ts`)
+- **ARIA Property Computation** - Attribute value resolution with HTML equivalents (`src/algorithm/aria/get-computed-aria-props.ts`)
+- **Required Context Validation** - Composite role validation (`src/algorithm/aria/has-required-owned-elements.ts`)
+
+**Specification Integration**:
+
+- Cross-specification utilities (`src/utils/get-spec-by-tag-name.ts`)
+- Version-aware specification resolution (`src/utils/resolve-version.ts`)
+- Schema-to-runtime conversion (`src/utils/schema-to-spec.ts`)
+
+### JSON Schemas (Structure Definitions)
+
+- `schemas/element.schema.json` - Element specification schema
+- `schemas/aria.schema.json` - ARIA specification schema
+- `schemas/content-models.schema.json` - Content model schema
+- `schemas/global-attributes.schema.json` (generated) - Global attribute categories
+- `schemas/attributes.schema.json` (generated) - Attribute definition schema
+
+### Schema Generators
+
+- `gen/gen.ts` - Builds generated schema files from data
+- `gen/global-attribute.data.*` - Source data for global attribute categories
+
+### Runtime Utilities
+
+- **Spec Resolution**: `getSpecByTagName`, `getAttrSpecs`, `getRoleSpec`
+- **Content Model Utilities**: `getContentModel`, `isPalpableElements`, `isVoidElement`
+- **ARIA Utilities**: `getAria`, `getPermittedRoles`, `hasRequiredOwnedElements`
+- **Accessibility Utilities**: `accnameComputation`, `isExposed`, `mayBeFocusable`
+- **Schema Utilities**: `schemaToSpec`, `resolveNamespace`, `validateAriaVersion`
+- **Framework Extension**: Merges base HTML specs with framework-specific extensions
+
+**Note**: Attribute value types are defined in `@markuplint/types`. The schemas here reference `@markuplint/types/types.schema.json`.
+
+## Relationship to @markuplint/html-spec
+
+**@markuplint/html-spec** provides the canonical HTML element specification data:
+
+- **Built output**: `index.json` (48K+ lines, consolidated specification data)
+- **Sources**: `src/spec-*.json` (individual element specifications)
+- **Build process**: `build.mjs` → `@markuplint/spec-generator` → enriched with MDN/W3C data
+
+**@markuplint/ml-spec** (this package) provides:
+
+- **Type definitions** that `@markuplint/html-spec` uses to structure its data
+- **JSON schemas** that validate the specification format
+- **Algorithms** that process and compute values from the specification data
+- **Runtime utilities** that consume the consolidated specification data
+
+This separation enables:
+
+- **Data updates** (`@markuplint/html-spec`) without affecting type definitions
+- **Algorithm improvements** (`@markuplint/ml-spec`) without regenerating data
+- **Framework extensions** that can reuse both type definitions and base HTML data
+
+### Install
+
+`markuplint` already bundles this package. If you need to install it explicitly:
+
+```bash
+npm install @markuplint/ml-spec
+# or
+yarn add @markuplint/ml-spec
+```
+
+### Terminology
+
+- "HTML Schema" and "Specs" are used interchangeably in markuplint to mean the JSON Schema that
+  describes HTML element specs (attributes, ARIA, content models, etc) and their TypeScript types.
+
+### Editing workflow (HTML Schema/Specs)
+
+1. Make changes to the schemas
+
+- Attributes schema shape: update `gen/gen.ts` if you need to change the structure of
+  `AttributeJSON`/`GlobalAttributes` (because `attributes.schema.json` is generated).
+- ARIA schema shape: edit `schemas/aria.schema.json`.
+- Content model schema shape: edit `schemas/content-models.schema.json`.
+- Element schema aggregator: edit `schemas/element.schema.json` (it composes refs to the above).
+- Global attribute categories/sets: edit `gen/global-attribute.data.*`, then regenerate via the commands below.
+
+If you want to change the concrete HTML element data (e.g., add/update element- or attribute-level
+entries), update `@markuplint/html-spec` (and, if necessary, `@markuplint/spec-generator`).
+
+2. Regenerate schemas and types
+
+From the repository root (recommended):
+
+```bash
+yarn up:schema
+```
+
+or only for this package:
+
+```bash
+yarn workspace @markuplint/ml-spec run schema
 ```
 
-</details>
+This will:
+
+- Run `gen/gen.ts` to output `global-attributes.schema.json` and `attributes.schema.json`
+- Convert JSON Schema to TypeScript via `json2ts` into `src/types/*.ts`
+- Format with Prettier and ESLint
+
+#### What `yarn up:schema` does
+
+From the repository root, this executes schema maintenance across packages in order:
+
+1. `@markuplint/types`
+
+- Run `gen/types.ts` to build `types.schema.json` from css-tree keywords/types and
+  `gen/specific-schema.json`
+- Generate TypeScript types: `types.schema.json` → `src/types.schema.ts` (via `json2ts`)
+- Format (`prettier`/`eslint`) and build the package
+
+2. `@markuplint/ml-spec` (this package)
+
+- Run `gen/gen.ts` to output `schemas/global-attributes.schema.json` and `schemas/attributes.schema.json`
+- Generate TypeScript types from schemas:
+  - `schemas/content-models.schema.json` → `src/types/permitted-structures.ts`
+  - `schemas/attributes.schema.json` → `src/types/attributes.ts`
+  - `schemas/aria.schema.json` → `src/types/aria.ts`
+- Format (`prettier`/`eslint`)
+
+Dependency note: `schemas/attributes.schema.json` references
+`@markuplint/types/types.schema.json#/definitions/type`. Updating types first ensures references stay
+consistent; `yarn up:schema` takes care of this order.
+
+3. Build (optional) and sanity-check
+
+```bash
+yarn build
+```
+
+### Do not edit generated files
+
+- Do not modify files under `src/types/*.ts` or `schemas/attributes.schema.json` directly.
+  Change the source schema or generator instead and re-run the generation scripts.
+
+### How schema merging works (Specs extension)
+
+At runtime, markuplint can merge multiple specs. The merger in
+`src/utils/schema-to-spec.ts` follows these rules:
+
+- `def.#globalAttrs.#extends` from an extended spec augments the base `#HTMLGlobalAttrs` map.
+- For a given element, if both base and extended specs define the same attribute, the extended spec
+  wins on conflicting fields (shallow override per attribute). Arrays like `categories` are merged.
+
+This enables framework-specific specs (Vue/React/Svelte, etc.) to extend the HTML spec safely.
+
+### Relationship to @markuplint/types
+
+- Attribute value types (CSS keywords, extended types such as `URL`, `JSON`, etc.) are defined in
+  `@markuplint/types` and exposed via `types.schema.json`.
+- If you need a new attribute value type, modify `@markuplint/types` (e.g.
+  `packages/@markuplint/types/gen/specific-schema.json`) and regenerate that package first. Then
+  regenerate this package so references stay consistent.
+
+### Versioning policy
+
+- HTML Schema/Specs are not part of the public API surface of markuplint. Changes here are treated
+  as a minor release. Publishing is handled by Lerna during the normal release process.
+
+### Common tasks (quick recipes)
+
+- Add a new global attribute category or items
+  - Edit `gen/global-attribute.data.*`
+  - Run the generation script (see above)
+
+- Add a new optional field to `AttributeJSON`
+  - Update the shape in `gen/gen.ts` under `AttributeJSON`
+  - Regenerate and ensure the new field appears in `schemas/attributes.schema.json` and in
+    `src/types/attributes.ts`
+
+- Adjust ARIA fields (e.g., `permittedRoles` variants)
+  - Edit `schemas/aria.schema.json`
+  - Regenerate types via the schema scripts
+
+### Content model quick reference
+
+Content models describe allowed children for each element. See the JSON Schema
+`schemas/content-models.schema.json` and the generated TS types `src/types/permitted-structures.ts`.
+Also refer to the website docs: [Rule: permitted-contents](https://markuplint.dev/rules/permitted-contents).
+
+- Basic categories (strings): `"#flow"`, `"#phrasing"`, `"#interactive"`, …
+- Model item forms:
+  - `require` | `optional` | `oneOrMore` | `zeroOrMore`: a string, category, or nested patterns
+  - `choice`: 2–5 alternative pattern arrays
+  - `transparent`: inherits parent model filtered by selector string
+
+Examples:
+
+```json
+{
+  "contentModel": {
+    "contents": [{ "require": "#phrasing" }, { "optional": [{ "oneOrMore": "#interactive" }] }]
+  }
+}
+```
+
+Transparent selector syntax
+
+- A CSS-like selector string with an extra pseudo: `:model(<CATEGORY>)`
+- You can combine standard selectors: type, class, id, attribute selectors, `:not(...)`, `:has(...)`,
+  combinators, etc.
+- `:model(<CATEGORY>)` matches any element belonging to the specified content category.
+
+Examples:
+
+```text
+:not(:model(interactive))
+:has(:model(interactive), a, [tabindex])
+```
+
+SVG categories
+
+The following categories are available for SVG elements (see `schemas/content-models.schema.json`):
+
+- `#SVGAnimation`
+- `#SVGBasicShapes`
+- `#SVGContainer`
+- `#SVGDescriptive`
+- `#SVGFilterPrimitive`
+- `#SVGFont`
+- `#SVGGradient`
+- `#SVGGraphics`
+- `#SVGGraphicsReferencing`
+- `#SVGLightSource`
+- `#SVGNeverRendered`
+- `#SVGNone`
+- `#SVGPaintServer`
+- `#SVGRenderable`
+- `#SVGShape`
+- `#SVGStructural`
+- `#SVGStructurallyExternal`
+- `#SVGTextContent`
+- `#SVGTextContentChild`
+
+```json
+{
+  "contentModel": {
+    "contents": [{ "choice": [[{ "oneOrMore": "#flow" }], [{ "require": "#phrasing" }]] }]
+  }
+}
+```
+
+```json
+{
+  "contentModel": {
+    "contents": [{ "transparent": ":not(:model(interactive))" }],
+    "conditional": [
+      {
+        "condition": "[type=button]",
+        "contents": [{ "require": "#phrasing" }]
+      }
+    ]
+  }
+}
+```
+
+### License
+
+MIT

package/lib/algorithm/aria/aria-specs.d.ts

@@ -0,0 +1,6 @@
+import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
+export declare function ariaSpecs(specs: MLMLSpec, version: ARIAVersion): {
+    readonly roles: readonly import("../../types/index.js").ARIARoleInSchema[];
+    readonly graphicsRoles: readonly import("../../types/index.js").ARIARoleInSchema[];
+    readonly props: readonly import("../../types/index.js").ARIAProperty[];
+};

package/lib/{specs → algorithm/aria}/get-aria.d.ts

@@ -1,4 +1,4 @@
-import type { ARIA } from '../types/aria.js';
-import type { ARIAVersion, Matches, MLMLSpec } from '../types/index.js';
+import type { ARIA } from '../../types/aria.js';
+import type { ARIAVersion, Matches, MLMLSpec } from '../../types/index.js';
 import type { ReadonlyDeep } from 'type-fest';
 export declare function getARIA(specs: MLMLSpec, localName: string, namespace: string | null, version: ARIAVersion, matches: Matches): Omit<ReadonlyDeep<ARIA>, ARIAVersion | 'conditions'> | null;

package/lib/{specs → algorithm/aria}/get-aria.js

@@ -1,5 +1,5 @@
-import { getSpecByTagName } from './get-spec-by-tag-name.js';
-import { resolveVersion } from './resolve-version.js';
+import { getSpecByTagName } from '../../utils/get-spec-by-tag-name.js';
+import { resolveVersion } from '../../utils/resolve-version.js';
 const cache = new Map();
 export function getARIA(specs, localName, namespace, version, matches) {
     const aria = getVersionResolvedARIA(specs, localName, namespace, version);

package/lib/{dom-traverse → algorithm/aria}/get-computed-aria-props.d.ts

@@ -1,4 +1,4 @@
-import type { ARIAVersion, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
 type ARIAProps = Record<string, ARIAProp>;
 type ARIAProp = {
     name: string;

package/lib/{dom-traverse → algorithm/aria}/get-computed-aria-props.js

@@ -1,4 +1,4 @@
-import { ariaSpecs as _ariaSpecs } from '../specs/aria-specs.js';
+import { ariaSpecs as _ariaSpecs } from './aria-specs.js';
 import { getComputedRole } from './get-computed-role.js';
 export function getComputedAriaProps(specs, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types

package/lib/{dom-traverse → algorithm/aria}/get-computed-role.d.ts

@@ -1,2 +1,2 @@
-import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, ComputedRole, MLMLSpec } from '../../types/index.js';
 export declare function getComputedRole(specs: MLMLSpec, el: Element, version: ARIAVersion, assumeSingleNode?: boolean): ComputedRole;

package/lib/{dom-traverse → algorithm/aria}/get-computed-role.js

@@ -1,13 +1,13 @@
-import { ariaSpecs } from '../specs/aria-specs.js';
-import { isPresentational } from '../specs/is-presentational.js';
+import { ariaSpecs } from './aria-specs.js';
+import { isPresentational } from './is-presentational.js';
 import { getAccname } from './accname-computation.js';
-import { getAttrSpecs } from './get-attr-specs.js';
+import { getAttrSpecs } from '../../utils/get-attr-specs.js';
 import { getExplicitRole } from './get-explicit-role.js';
 import { getImplicitRole } from './get-implicit-role.js';
 import { getNonPresentationalAncestor } from './get-non-presentational-ancestor.js';
 import { isRequiredOwnedElement } from './has-required-owned-elements.js';
 import { matchesContextRole } from './matches-context-role.js';
-import { mayBeFocusable } from './may-be-focusable.js';
+import { mayBeFocusable } from '../html/may-be-focusable.js';
 export function getComputedRole(specs, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 el, version, assumeSingleNode = false) {

package/lib/{dom-traverse → algorithm/aria}/get-explicit-role.d.ts

@@ -1,2 +1,2 @@
-import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, ComputedRole, MLMLSpec } from '../../types/index.js';
 export declare function getExplicitRole(specs: MLMLSpec, el: Element, version: ARIAVersion): ComputedRole;

package/lib/{dom-traverse → algorithm/aria}/get-explicit-role.js

@@ -1,5 +1,5 @@
-import { getRoleSpec } from '../specs/get-role-spec.js';
-import { resolveNamespace } from '../utils/resolve-namespace.js';
+import { getRoleSpec } from './get-role-spec.js';
+import { resolveNamespace } from '../../utils/resolve-namespace.js';
 import { getPermittedRoles } from './get-permitted-roles.js';
 export function getExplicitRole(specs, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types

package/lib/algorithm/aria/get-implicit-role-spec.d.ts

@@ -0,0 +1,2 @@
+import type { ARIAVersion, Matches, MLMLSpec } from '../../types/index.js';
+export declare function getImplicitRole(specs: MLMLSpec, localName: string, namespace: string | null, version: ARIAVersion, matches: Matches): import("../../index.js").ImplicitRole;

package/lib/{dom-traverse → algorithm/aria}/get-implicit-role.d.ts

@@ -1,4 +1,4 @@
-import type { ImplicitRole } from '../types/aria.js';
-import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types/index.js';
+import type { ImplicitRole } from '../../types/aria.js';
+import type { ARIAVersion, ComputedRole, MLMLSpec } from '../../types/index.js';
 export declare function getImplicitRole(specs: MLMLSpec, el: Element, version: ARIAVersion): ComputedRole;
 export declare function getImplicitRoleName(el: Element, version: ARIAVersion, specs: MLMLSpec): ImplicitRole;

package/lib/{dom-traverse → algorithm/aria}/get-implicit-role.js

@@ -1,6 +1,6 @@
-import { getImplicitRole as _getImplicitRole } from '../specs/get-implicit-role.js';
-import { getRoleSpec } from '../specs/get-role-spec.js';
-import { resolveNamespace } from '../utils/resolve-namespace.js';
+import { getImplicitRole as _getImplicitRole } from './get-implicit-role-spec.js';
+import { getRoleSpec } from './get-role-spec.js';
+import { resolveNamespace } from '../../utils/resolve-namespace.js';
 export function getImplicitRole(specs, 
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 el, version) {

package/lib/algorithm/aria/get-non-presentational-ancestor.d.ts

@@ -0,0 +1,5 @@
+import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
+export declare function getNonPresentationalAncestor(el: Element, specs: MLMLSpec, version: ARIAVersion): import("../../types/index.js").ComputedRole | {
+    el: null;
+    role: null;
+};

package/lib/{dom-traverse → algorithm/aria}/get-non-presentational-ancestor.js

@@ -1,4 +1,4 @@
-import { isPresentational } from '../specs/is-presentational.js';
+import { isPresentational } from './is-presentational.js';
 import { getComputedRole } from './get-computed-role.js';
 export function getNonPresentationalAncestor(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types

package/lib/{specs/get-permitted-roles.d.ts → algorithm/aria/get-permitted-roles-spec.d.ts}

@@ -1,4 +1,4 @@
-import type { ARIAVersion, Matches, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, Matches, MLMLSpec } from '../../types/index.js';
 /**
  * Getting permitted ARIA roles.
  *

package/lib/{specs/get-permitted-roles.js → algorithm/aria/get-permitted-roles-spec.js}

@@ -1,6 +1,6 @@
 // @ts-ignore
 import { isPlainObject } from 'is-plain-object';
-import { mergeArray } from '../utils/merge-array.js';
+import { mergeArray } from '../../utils/merge-array.js';
 import { ariaSpecs } from './aria-specs.js';
 import { getARIA } from './get-aria.js';
 /**

package/lib/{dom-traverse → algorithm/aria}/get-permitted-roles.d.ts

@@ -1,4 +1,4 @@
-import type { ARIAVersion, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
 export declare function getPermittedRoles(el: Element, version: ARIAVersion, specs: MLMLSpec): readonly {
     readonly name: string;
     readonly deprecated?: boolean;

package/lib/{dom-traverse → algorithm/aria}/get-permitted-roles.js

@@ -1,4 +1,4 @@
-import { getPermittedRoles as _getPermittedRoles } from '../specs/get-permitted-roles.js';
+import { getPermittedRoles as _getPermittedRoles } from './get-permitted-roles-spec.js';
 export function getPermittedRoles(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 el, version, specs) {

package/lib/{specs → algorithm/aria}/get-role-spec.d.ts

@@ -1,4 +1,4 @@
-import type { ARIAVersion, ARIARoleInSchema, MLMLSpec, ARIARole } from '../types/index.js';
+import type { ARIAVersion, ARIARoleInSchema, MLMLSpec, ARIARole } from '../../types/index.js';
 import type { NamespaceURI } from '@markuplint/ml-ast';
 export declare function getRoleSpec(specs: MLMLSpec, roleName: string, namespace: NamespaceURI, version: ARIAVersion): (ARIARole & {
     superClassRoles: ARIARoleInSchema[];

package/lib/{dom-traverse → algorithm/aria}/has-required-owned-elements.d.ts

@@ -1,3 +1,3 @@
-import type { ARIAVersion, ComputedRole, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, ComputedRole, MLMLSpec } from '../../types/index.js';
 export declare function hasRequiredOwnedElement(el: Element, specs: MLMLSpec, version: ARIAVersion): boolean;
 export declare function isRequiredOwnedElement(el: Element, role: ComputedRole['role'], query: string, specs: MLMLSpec, version: ARIAVersion): boolean;

package/lib/{dom-traverse → algorithm/aria}/has-required-owned-elements.js

@@ -1,4 +1,4 @@
-import { isPresentational } from '../specs/is-presentational.js';
+import { isPresentational } from './is-presentational.js';
 import { getComputedRole } from './get-computed-role.js';
 import { getExplicitRole } from './get-explicit-role.js';
 import { getImplicitRole } from './get-implicit-role.js';

package/lib/{dom-traverse → algorithm/aria}/is-exposed.d.ts

@@ -1,4 +1,4 @@
-import type { ARIAVersion, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
 /**
  * Detect including/excluding from the Accessibility Tree
  *

package/lib/{dom-traverse → algorithm/aria}/is-exposed.js

@@ -1,7 +1,7 @@
-import { ariaSpecs } from '../specs/aria-specs.js';
-import { getSpecByTagName } from '../specs/get-spec-by-tag-name.js';
-import { isPresentational } from '../specs/is-presentational.js';
-import { resolveNamespace } from '../utils/resolve-namespace.js';
+import { ariaSpecs } from './aria-specs.js';
+import { getSpecByTagName } from '../../utils/get-spec-by-tag-name.js';
+import { isPresentational } from './is-presentational.js';
+import { resolveNamespace } from '../../utils/resolve-namespace.js';
 import { getComputedRole } from './get-computed-role.js';
 /**
  * Detect including/excluding from the Accessibility Tree

package/lib/{dom-traverse → algorithm/aria}/matches-context-role.d.ts

@@ -1,2 +1,2 @@
-import type { ARIAVersion, MLMLSpec } from '../types/index.js';
+import type { ARIAVersion, MLMLSpec } from '../../types/index.js';
 export declare function matchesContextRole(conditions: readonly string[], ownedEl: Element, specs: MLMLSpec, version: ARIAVersion): boolean;

package/lib/{specs → algorithm/html}/content-model-category-to-tag-names.d.ts

@@ -1,3 +1,3 @@
-import type { MLMLSpec } from '../types/index.js';
-import type { Category } from '../types/permitted-structures.js';
+import type { MLMLSpec } from '../../types/index.js';
+import type { Category } from '../../types/permitted-structures.js';
 export declare function contentModelCategoryToTagNames(contentModel: Category, def: MLMLSpec['def']): ReadonlyArray<string>;

package/lib/algorithm/html/get-content-model.d.ts

@@ -0,0 +1,4 @@
+import type { ElementSpec } from '../../types/index.js';
+type Specs = readonly Pick<ElementSpec, 'name' | 'contentModel'>[];
+export declare function getContentModel(el: Element, specs: Specs): boolean | readonly (import("type-fest/source/readonly-deep.js").ReadonlyObjectDeep<import("../../types/permitted-structures.js").PermittedContentRequire> | import("type-fest/source/readonly-deep.js").ReadonlyObjectDeep<import("../../types/permitted-structures.js").PermittedContentOptional> | import("type-fest/source/readonly-deep.js").ReadonlyObjectDeep<import("../../types/permitted-structures.js").PermittedContentOneOrMore> | import("type-fest/source/readonly-deep.js").ReadonlyObjectDeep<import("../../types/permitted-structures.js").PermittedContentZeroOrMore> | import("type-fest/source/readonly-deep.js").ReadonlyObjectDeep<import("../../types/permitted-structures.js").PermittedContentChoice> | import("type-fest/source/readonly-deep.js").ReadonlyObjectDeep<import("../../types/permitted-structures.js").PermittedContentTransparent>)[] | null;
+export {};

package/lib/{dom-traverse → algorithm/html}/get-content-model.js

@@ -1,4 +1,4 @@
-import { getSpec } from './get-spec.js';
+import { getSpec } from '../../utils/get-spec.js';
 const cachesBySpecs = new Map();
 export function getContentModel(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types

package/lib/algorithm/html/get-selectors-by-content-model-category.d.ts

@@ -0,0 +1,3 @@
+import type { MLMLSpec } from '../../types/index.js';
+import type { Category } from '../../types/permitted-structures.js';
+export declare function getSelectorsByContentModelCategory(specs: MLMLSpec, category: Category): ReadonlyArray<string>;

package/lib/{specs → algorithm/html}/is-palpable-elements.d.ts

@@ -1,4 +1,4 @@
-import type { MLMLSpec } from '../types/index.js';
+import type { MLMLSpec } from '../../types/index.js';
 export declare function isPalpableElement(el: Element, specs: MLMLSpec, options?: {
     readonly extendsSvg?: boolean;
     readonly extendsExposableElements?: boolean;

package/lib/{dom-traverse → algorithm/html}/may-be-focusable.d.ts

@@ -1,2 +1,2 @@
-import type { MLMLSpec } from '../types/index.js';
+import type { MLMLSpec } from '../../types/index.js';
 export declare function mayBeFocusable(el: Element, specs: MLMLSpec): boolean;

package/lib/{dom-traverse → algorithm/html}/may-be-focusable.js

@@ -1,4 +1,4 @@
-import { getSelectorsByContentModelCategory } from '../specs/get-selectors-by-content-model-category.js';
+import { getSelectorsByContentModelCategory } from './get-selectors-by-content-model-category.js';
 export function mayBeFocusable(
 // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
 el, specs) {