diff --git a/.changeset/wpt-framework-profiles.md b/.changeset/wpt-framework-profiles.md new file mode 100644 index 0000000..d486bbb --- /dev/null +++ b/.changeset/wpt-framework-profiles.md @@ -0,0 +1,5 @@ +--- +'@bomb.sh/web-platform-tests': patch +--- + +Adds framework profiles that map the DOM features React 19.3, Preact 11.2, Vue 3.5, Solid 1.9, and Svelte 5.57 use to the WPT cases covering them. `framework()` returns selectors for a framework and its optional modules, and `uncoveredByWPT()` lists required features without adapted WPT coverage. diff --git a/packages/web-platform-tests/src/frameworks/features.ts b/packages/web-platform-tests/src/frameworks/features.ts new file mode 100644 index 0000000..2dfedfb --- /dev/null +++ b/packages/web-platform-tests/src/frameworks/features.ts @@ -0,0 +1,234 @@ +import type { WPTSelectors } from '../shared/selection.ts'; + +/** + * DOM members measured in framework runtimes, keyed by interface member, mapped to the adapted + * WPT cases that exercise them. An empty selector map means no adapted WPT source covers the + * member yet; it stays listed so profiles keep recording the requirement. + */ +export const features = { + // Document + 'Document#createElement': { 'dom/nodes/Document-createElement.html': true }, + 'Document#createElementNS': { 'dom/nodes/Document-createElementNS.html': true }, + 'Document#createTextNode': { 'dom/nodes/Document-createTextNode.html': true }, + 'Document#createComment': { 'dom/nodes/Document-createComment.html': true }, + 'Document#createDocumentFragment': {}, + 'Document#activeElement': { 'html/editing/focus/focus-management/focus-blur.html': true }, + 'Document#defaultView': {}, + 'Document#head': {}, + 'Document#documentElement': {}, + 'Document#contentType': {}, + 'Document#importNode': { + 'dom/nodes/Document-importNode.html': [/'deep' argument\.$/], + }, + 'Document#createTreeWalker': { + 'dom/traversal/TreeWalker-basic.html': true, + 'dom/traversal/TreeWalker-acceptNode-filter.html': true, + 'dom/traversal/TreeWalker-traversal-reject.html': true, + 'dom/traversal/TreeWalker-traversal-skip.html': true, + }, + 'Document#createRange': { + 'dom/ranges/Range-constructor.html': true, + 'dom/ranges/Range-attributes.html': true, + }, + + // Node + 'Node#nodeType': {}, + 'Node#ownerDocument': {}, + 'Node#parentNode': { + 'dom/nodes/Node-parentNode.html': ['sets the parent of an appended element', 'Root element'], + }, + 'Node#firstChild': {}, + 'Node#lastChild': {}, + 'Node#nextSibling': {}, + 'Node#childNodes': { 'dom/nodes/Node-childNodes.html': true }, + 'Node#insertBefore': { 'dom/nodes/Node-insertBefore.html': true }, + 'Node#appendChild': {}, + 'Node#removeChild': { 'dom/nodes/Node-removeChild.html': true }, + 'Node#replaceChild': { 'dom/nodes/Node-replaceChild.html': true }, + 'Node#cloneNode': { 'dom/nodes/Node-cloneNode.html': true }, + // Frameworks never create ProcessingInstruction or DocumentType nodes, nor set Document text. + 'Node#textContent': { + 'dom/nodes/Node-textContent.html': [/^(?!.*(ProcessingInstruction|DocumentType|Documents))/], + }, + 'Node#nodeValue': { 'dom/nodes/Node-nodeValue.html': ['Text.nodeValue', 'Comment.nodeValue'] }, + 'Node#contains': { 'dom/nodes/Node-contains.html': true }, + 'Node#getRootNode': {}, + 'Node#isConnected': { 'dom/nodes/Node-isConnected.html': true }, + 'Node#compareDocumentPosition': { 'dom/nodes/Node-compareDocumentPosition.html': true }, + + // ChildNode / ParentNode / CharacterData + 'ChildNode#remove': { + 'dom/nodes/Element-remove.html': true, + 'dom/nodes/CharacterData-remove.html': [ + /^(text|comment) should support remove\(\)$/, + /if (text|comment) /, + ], + }, + 'ChildNode#before': {}, + 'ParentNode#moveBefore': {}, + 'ChildNode#after': {}, + 'ParentNode#children': { 'dom/nodes/ParentNode-children.html': true }, + 'CharacterData#data': { 'dom/nodes/CharacterData-data.html': true }, + + // Element + 'Element#setAttribute': { + 'dom/nodes/Element-setAttribute.html': true, + 'dom/nodes/Element-setAttribute-crbug-1138487.html': true, + 'dom/nodes/attributes.html': [/\bsetAttribute\b/], + }, + 'Element#getAttribute': { + 'dom/nodes/attributes.html': [ + 'Unset attributes return null', + 'First set attribute is returned by getAttribute', + 'Only lowercase attributes are returned on HTML elements (upper case attribute)', + 'Only lowercase attributes are returned on HTML elements (mixed case attribute)', + ], + }, + 'Element#namespaceURI': { 'dom/nodes/Document-createElementNS.html': true }, + 'Element#localName': { + 'dom/nodes/Document-createElement.html': true, + 'dom/nodes/Document-createElementNS.html': true, + }, + 'Element#id': {}, + 'Element#tagName': {}, + 'Element#nodeName': {}, + 'Element#removeAttribute': { 'dom/nodes/Element-removeAttribute.html': true }, + 'Element#className': { 'html/dom/reflection-misc.html': [/^html\.className /] }, + 'Element#classList': { 'dom/nodes/Element-classlist.html': true }, + 'Element#innerHTML': { + 'domparsing/innerhtml-04.html': true, + 'domparsing/innerhtml-07.html': true, + 'domparsing/innerhtml-08.html': true, + 'domparsing/innerhtml-li-autoclosing.html': true, + 'html/syntax/serializing-html-fragments/serializing.html': [/^innerHTML /], + }, + // Svelte's select binding queries `:checked`, `[selected]`, and `option:not([disabled])` only. + 'Element#querySelector': { 'html/semantics/selectors/pseudo-classes/checked.html': true }, + 'DocumentFragment#querySelectorAll': { + 'dom/nodes/DocumentFragment-querySelectorAll-after-modification.html': true, + }, + 'Element#attachShadow': { 'shadow-dom/Element-interface-attachShadow.html': true }, + + // HTMLElement and CSSOM + 'HTMLElement#style': { + 'css/cssom/css-style-attr-decl-block.html': true, + 'css/cssom/css-style-attribute-modifications.html': true, + 'css/cssom/CSSStyleDeclaration-indexed-properties.html': true, + }, + 'CSSStyleDeclaration#setProperty': { 'css/cssom/cssom-setProperty-shorthand.html': true }, + getComputedStyle: { 'css/cssom/computed-style-001.html': true }, + 'HTMLElement#contentEditable': {}, + 'HTMLElement#focus': { + 'html/editing/focus/focus-management/focus-blur.html': true, + 'html/interaction/focus/focus-management/focus-events.html': true, + }, + 'HTMLTemplateElement#content': { + 'html/semantics/scripting-1/the-template-element/definitions/template-contents.html': true, + 'html/semantics/scripting-1/the-template-element/innerhtml-on-templates/innerhtml.html': true, + 'html/semantics/scripting-1/the-template-element/additions-to-the-steps-to-clone-a-node/template-clone-children.html': true, + }, + + // Form controls. Reflection must use prototype accessors (React's value tracker); no WPT covers that. + 'HTMLInputElement#value': { + 'html/semantics/forms/the-input-element/input-value-dirty-flag.html': true, + 'html/semantics/forms/the-input-element/text.html': [/^(Value returns|Setting value changes)/], + }, + 'HTMLInputElement#type': { + 'html/semantics/forms/the-input-element/input-value-dirty-flag.html': [ + "Input type defaults to 'text' on the property despite no attribute", + 'Setting input type property sets the attribute', + ], + }, + 'HTMLInputElement#name': {}, + 'HTMLInputElement#defaultValue': { + 'html/semantics/forms/the-input-element/input-value-dirty-flag.html': [ + 'Input value/defaultValue dirty value flag semantics', + ], + }, + 'HTMLInputElement#defaultChecked': { + 'html/semantics/forms/the-input-element/input-value-dirty-flag.html': [ + 'Input checked/defaultChecked dirty checkedness semantics', + ], + }, + 'HTMLInputElement#selectionStart': { + 'html/semantics/forms/textfieldselection/defaultSelection.html': true, + }, + 'HTMLInputElement#selectionEnd': { + 'html/semantics/forms/textfieldselection/defaultSelection.html': true, + }, + 'HTMLInputElement#disabled': { 'html/semantics/selectors/pseudo-classes/disabled.html': true }, + 'HTMLButtonElement#disabled': { 'html/semantics/selectors/pseudo-classes/disabled.html': true }, + 'HTMLTextAreaElement#disabled': { + 'html/semantics/selectors/pseudo-classes/disabled.html': true, + }, + 'HTMLOptionElement#disabled': { 'html/semantics/selectors/pseudo-classes/disabled.html': true }, + 'HTMLInputElement#checked': { + 'html/semantics/forms/the-input-element/input-value-dirty-flag.html': [ + 'Input checked/defaultChecked dirty checkedness semantics', + ], + 'html/semantics/forms/the-input-element/checkbox-click-events.html': true, + }, + 'HTMLInputElement#setSelectionRange': { + 'html/semantics/forms/textfieldselection/selection.html': true, + }, + 'HTMLTextAreaElement#value': { + 'html/semantics/forms/the-textarea-element/value-defaultValue-textContent.html': true, + }, + 'HTMLTextAreaElement#defaultValue': { + 'html/semantics/forms/the-textarea-element/value-defaultValue-textContent.html': true, + }, + 'HTMLOptionElement#value': { 'html/semantics/forms/the-option-element/option-value.html': true }, + 'HTMLOptionElement#selected': { + 'html/semantics/forms/the-option-element/option-selected.html': true, + }, + 'HTMLSelectElement#value': { + 'html/semantics/forms/the-select-element/select-value.html': true, + 'html/semantics/forms/the-select-element/selected-index.html': true, + }, + + // Events + 'EventTarget#addEventListener': { + 'dom/events/EventTarget-addEventListener.any.js': true, + 'dom/events/EventTarget-add-remove-listener.any.js': true, + 'dom/events/AddEventListenerOptions-once.any.js': true, + 'dom/events/AddEventListenerOptions-passive.any.js': true, + 'dom/events/AddEventListenerOptions-signal.any.js': true, + 'dom/events/EventListenerOptions-capture.html': true, + 'dom/events/EventListener-handleEvent.html': true, + 'dom/events/EventTarget-this-of-listener.html': true, + }, + 'EventTarget#removeEventListener': { + 'dom/events/EventTarget-removeEventListener.any.js': true, + 'dom/events/remove-all-listeners.html': true, + }, + // Capture/target/bubble over the ancestor path, with target/currentTarget maintenance. + 'EventTarget#dispatchEvent': { + 'dom/events/EventTarget-dispatchEvent.html': true, + 'dom/events/EventTarget-dispatchEvent-returnvalue.html': true, + 'dom/events/Event-dispatch-bubbles-false.html': true, + 'dom/events/Event-dispatch-bubbles-true.html': true, + 'dom/events/Event-dispatch-handlers-changed.html': true, + 'dom/events/Event-dispatch-multiple-cancelBubble.html': true, + 'dom/events/Event-dispatch-multiple-stopPropagation.html': true, + 'dom/events/Event-dispatch-propagation-stopped.html': true, + 'dom/events/Event-dispatch-reenter.html': true, + 'dom/events/Event-dispatch-target-moved.html': true, + 'dom/events/Event-dispatch-throwing.html': true, + 'dom/events/Event-stopImmediatePropagation.html': true, + 'dom/events/Event-defaultPrevented-after-dispatch.html': true, + }, + Event: { 'dom/events/Event-constructors.any.js': true }, + 'Event#composedPath': { + 'shadow-dom/event-composed-path.html': ['Event Path without ShadowRoots.'], + }, + // React feature-detects event support through handler IDL attributes. + 'GlobalEventHandlers#onclick': {}, + 'Event#isTrusted': {}, + 'MutationObserver#observe': { 'dom/nodes/MutationObserver-sanity.html': true }, + 'MutationObserver#disconnect': { 'dom/nodes/MutationObserver-takeRecords.html': true }, + 'MutationObserver#childList': { + 'dom/nodes/MutationObserver-childList.html': [/^childList (?!Range\.|Node\.normalize)/], + }, +} as const satisfies Record; + +export type DOMFeature = keyof typeof features; diff --git a/packages/web-platform-tests/src/frameworks/frameworks.ts b/packages/web-platform-tests/src/frameworks/frameworks.ts new file mode 100644 index 0000000..d55614d --- /dev/null +++ b/packages/web-platform-tests/src/frameworks/frameworks.ts @@ -0,0 +1,231 @@ +import { CompatibilityConfigurationError, type WPTSelectors } from '../shared/selection.ts'; +import { features, type DOMFeature } from './features.ts'; + +interface FrameworkProfile { + /** Non-hydrated mount, update, and unmount of a typical application. */ + required: readonly DOMFeature[]; + /** Opt-in renderer modules, each enabled only when the integration supports it. */ + optional: Readonly>; +} + +/** Shared by every measured framework. */ +const core = [ + 'Element#innerHTML', + 'Element#setAttribute', + 'EventTarget#addEventListener', + 'EventTarget#dispatchEvent', + 'Event', + 'HTMLElement#style', + 'CSSStyleDeclaration#setProperty', + 'Document#createTextNode', + 'Node#nodeType', + 'HTMLInputElement#value', + 'HTMLInputElement#checked', + 'HTMLInputElement#type', + 'HTMLTextAreaElement#value', +] as const satisfies readonly DOMFeature[]; + +/** + * Measured DOM baseline per framework, from the non-hydrated happy-dom recorder study. + * Recorded against React 19.3.1, Preact 11.2.0, Vue 3.5.45, Solid 1.9.19, and Svelte 5.57.3. + */ +export const frameworks = { + react: { + required: [ + ...core, + 'Document#createElement', + 'Document#createElementNS', + 'Node#insertBefore', + 'Node#firstChild', + 'Node#textContent', + 'Node#ownerDocument', + 'Element#removeAttribute', + 'Node#nodeValue', + 'Node#appendChild', + 'Node#removeChild', + 'HTMLOptionElement#value', + 'HTMLOptionElement#selected', + 'HTMLSelectElement#value', + 'Document#activeElement', + 'Document#defaultView', + 'Document#documentElement', + 'Node#lastChild', + 'Node#getRootNode', + 'Node#contains', + 'HTMLElement#contentEditable', + 'Event#composedPath', + 'Event#isTrusted', + 'Element#namespaceURI', + 'Element#tagName', + 'Element#nodeName', + 'GlobalEventHandlers#onclick', + 'HTMLInputElement#name', + 'HTMLInputElement#defaultValue', + 'HTMLInputElement#defaultChecked', + 'HTMLInputElement#selectionStart', + 'HTMLInputElement#selectionEnd', + 'HTMLTextAreaElement#defaultValue', + 'HTMLOptionElement#disabled', + ], + optional: { + // Resource hoisting inserts ,