@teaflask/assistant 0.6.0 → 0.7.1

package/README.md

@@ -156,7 +156,7 @@ Next, [connect actions to your API](https://docs.teaflask.com/adapters), [identi
 - [Assistant UI](https://docs.teaflask.com/assistant-ui)
 - [Trust](https://docs.teaflask.com/trust)
 
-Requires `react` and `react-dom` 18.3 or 19, and `use-stick-to-bottom` (npm installs peers for you; the script tag needs none of them). The package is pre-1.0: a breaking change bumps the minor version, and the [changelog](https://github.com/teaflask/assistant/blob/main/CHANGELOG.md) lists what changed in every release. You can inspect the published code on [npm](https://www.npmjs.com/package/@teaflask/assistant?activeTab=code) or [unpkg](https://unpkg.com/@teaflask/assistant/).
+Requires `react` and `react-dom` 18.3 or 19 (the script tag needs neither). The package is pre-1.0: a breaking change bumps the minor version, and the [changelog](https://github.com/teaflask/assistant/blob/main/CHANGELOG.md) lists what changed in every release. Every public export and field is described in the package's types, and the script tag's attributes and properties in its `custom-elements.json`, so your editor and coding agent can read what each one means. You can inspect the published code on [npm](https://www.npmjs.com/package/@teaflask/assistant?activeTab=code) or [unpkg](https://unpkg.com/@teaflask/assistant/).
 
 ## License
 

package/custom-elements.json

@@ -0,0 +1,264 @@
+{
+  "schemaVersion": "2.1.0",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "https://app.teaflask.com/assistant/v1/assistant.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "TeaflaskAssistantPageElement",
+          "customElement": true,
+          "tagName": "teaflask-assistant-page",
+          "description": "The full-page assistant for any page, loaded with a script tag: the conversation with a header, a history menu and a new-conversation button. It fills its container, so give the element a height.",
+          "attributes": [
+            {
+              "name": "publishable-key",
+              "type": {
+                "text": "string"
+              },
+              "description": "Your agent's publishable key from Teaflask. Nothing renders until it is set, and requests are accepted only from your allowed origins. Changing it starts a separate session."
+            },
+            {
+              "name": "base-url",
+              "type": {
+                "text": "string"
+              },
+              "description": "The Teaflask API origin, which defaults to https://api.teaflask.com. Changing it starts a separate session."
+            },
+            {
+              "name": "mode",
+              "type": {
+                "text": "string"
+              },
+              "description": "The color palette: \"light\", \"dark\", or \"auto\" to follow the visitor's operating-system setting. Any other value warns in the console and uses the default."
+            },
+            {
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "description": "The name shown in the page's header, which defaults to \"Assistant\". It is called heading, not title, so it doesn't show a native tooltip over the page."
+            },
+            {
+              "name": "frameless",
+              "type": {
+                "text": "string"
+              },
+              "description": "Removes the page's own border and rounded corners so it sits flush inside a frame you already draw. Present with no value, or \"true\", turns it on; \"false\" turns it off."
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "onNavigate",
+              "type": {
+                "text": "((path: string) => void | Promise<void>) | null | undefined"
+              },
+              "description": "Called with an app-relative path when the agent takes the user to a page. Leave it unset and the page does a full-page load to that path; set a function to use your own router, or null to tell the agent this page cannot navigate."
+            },
+            {
+              "kind": "field",
+              "name": "userId",
+              "type": {
+                "text": "string | null | undefined"
+              },
+              "description": "Your stable id for the signed-in user, set together with getEndUserToken. It must equal the user_id claim in the token; setting only one of the two runs the session anonymously, with a console warning."
+            },
+            {
+              "kind": "field",
+              "name": "getEndUserToken",
+              "type": {
+                "text": "(() => string | Promise<string | null> | null) | null | undefined"
+              },
+              "description": "Returns a short-lived token from your backend proving who the user is: an HS256 JWT with user_id and exp (and optionally email), signed with the JWT secret from Settings → Keys in Teaflask. Set it together with userId; returning null continues anonymously."
+            },
+            {
+              "kind": "field",
+              "name": "actionsAdapter",
+              "type": {
+                "text": "ActionsAdapter | null | undefined"
+              },
+              "description": "How this page calls your API when the agent runs an action: { kind: \"cookies\", baseUrl }, { kind: \"headers\", baseUrl, getHeaders }, or { kind: \"request\", execute }. Without one, or with an unrecognized kind (which warns), the agent cannot run actions here and tells the user to do the step themselves."
+            },
+            {
+              "kind": "field",
+              "name": "onError",
+              "type": {
+                "text": "((error: Error) => void) | null | undefined"
+              },
+              "description": "Called with errors for your error reporting, such as a failed send, a dropped stream or a failed session-token request."
+            },
+            {
+              "kind": "field",
+              "name": "theme",
+              "type": {
+                "text": "AssistantTheme | null | undefined"
+              },
+              "description": "Theme tokens and dark-mode overrides, the same object as the React theme prop. Under a strict Content Security Policy this needs inline styles allowed; otherwise set the --tf- CSS variables in your own CSS."
+            },
+            {
+              "kind": "field",
+              "name": "suggestions",
+              "type": {
+                "text": "readonly AssistantSuggestionInput[] | null | undefined"
+              },
+              "description": "Opening prompts shown under the message box before the first message, as strings or { prompt, kind } objects. The full-page assistant shows none unless you set them."
+            },
+            {
+              "kind": "field",
+              "name": "toolViews",
+              "type": {
+                "text": "Readonly<Record<string, ToolViewRegistration>> | null | undefined"
+              },
+              "description": "Your own components for displaying specific tools and actions, keyed by tool name (action__<slug> for an action), the same registry as the React toolViews prop. It can be set before or after the element loads and reaches calls already on screen; keys starting with teaflask. and malformed entries are dropped one by one with a console warning."
+            }
+          ]
+        },
+        {
+          "kind": "class",
+          "name": "TeaflaskAssistantElement",
+          "customElement": true,
+          "tagName": "teaflask-assistant",
+          "description": "The all-in-one assistant for any page, loaded with a script tag: the corner widget, which opens the chat drawer, and the ⌘K palette. React is bundled inside. Use one per page, in markup that every page shares.",
+          "attributes": [
+            {
+              "name": "publishable-key",
+              "type": {
+                "text": "string"
+              },
+              "description": "Your agent's publishable key from Teaflask. Nothing renders until it is set, and requests are accepted only from your allowed origins. Changing it starts a separate session."
+            },
+            {
+              "name": "base-url",
+              "type": {
+                "text": "string"
+              },
+              "description": "The Teaflask API origin, which defaults to https://api.teaflask.com. Changing it starts a separate session."
+            },
+            {
+              "name": "mode",
+              "type": {
+                "text": "string"
+              },
+              "description": "The color palette: \"light\", \"dark\", or \"auto\" to follow the visitor's operating-system setting. Any other value warns in the console and uses the default."
+            },
+            {
+              "name": "corner",
+              "type": {
+                "text": "string"
+              },
+              "description": "The screen corner where the widget and its drawer sit: \"bottom-right\" (the default) or \"bottom-left\"."
+            },
+            {
+              "name": "hotkey",
+              "type": {
+                "text": "string"
+              },
+              "description": "The keyboard shortcut that toggles the palette, which defaults to \"mod+k\" (⌘ on macOS, Ctrl elsewhere); for example \"mod+j\" or \"ctrl+shift+p\". Set \"false\" to disable it; an unrecognized value also disables it, with a console warning."
+            },
+            {
+              "name": "companion-mark-src",
+              "type": {
+                "text": "string"
+              },
+              "description": "The URL of your own logo or mascot image, shown on the corner widget and on the drawer's welcome screen. If the image fails to load, the Teaflask flask is shown instead."
+            }
+          ],
+          "members": [
+            {
+              "kind": "method",
+              "name": "openPalette",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Opens the ⌘K palette, even when the hotkey is disabled or rebound. Does nothing before the element has a publishable key."
+            },
+            {
+              "kind": "field",
+              "name": "onNavigate",
+              "type": {
+                "text": "((path: string) => void | Promise<void>) | null | undefined"
+              },
+              "description": "Called with an app-relative path when the agent takes the user to a page. Leave it unset and the page does a full-page load to that path; set a function to use your own router, or null to tell the agent this page cannot navigate."
+            },
+            {
+              "kind": "field",
+              "name": "userId",
+              "type": {
+                "text": "string | null | undefined"
+              },
+              "description": "Your stable id for the signed-in user, set together with getEndUserToken. It must equal the user_id claim in the token; setting only one of the two runs the session anonymously, with a console warning."
+            },
+            {
+              "kind": "field",
+              "name": "getEndUserToken",
+              "type": {
+                "text": "(() => string | Promise<string | null> | null) | null | undefined"
+              },
+              "description": "Returns a short-lived token from your backend proving who the user is: an HS256 JWT with user_id and exp (and optionally email), signed with the JWT secret from Settings → Keys in Teaflask. Set it together with userId; returning null continues anonymously."
+            },
+            {
+              "kind": "field",
+              "name": "actionsAdapter",
+              "type": {
+                "text": "ActionsAdapter | null | undefined"
+              },
+              "description": "How this page calls your API when the agent runs an action: { kind: \"cookies\", baseUrl }, { kind: \"headers\", baseUrl, getHeaders }, or { kind: \"request\", execute }. Without one, or with an unrecognized kind (which warns), the agent cannot run actions here and tells the user to do the step themselves."
+            },
+            {
+              "kind": "field",
+              "name": "onError",
+              "type": {
+                "text": "((error: Error) => void) | null | undefined"
+              },
+              "description": "Called with errors for your error reporting, such as a failed send, a dropped stream or a failed session-token request."
+            },
+            {
+              "kind": "field",
+              "name": "theme",
+              "type": {
+                "text": "AssistantTheme | null | undefined"
+              },
+              "description": "Theme tokens and dark-mode overrides, the same object as the React theme prop. Under a strict Content Security Policy this needs inline styles allowed; otherwise set the --tf- CSS variables in your own CSS."
+            },
+            {
+              "kind": "field",
+              "name": "suggestions",
+              "type": {
+                "text": "readonly AssistantSuggestionInput[] | null | undefined"
+              },
+              "description": "Opening prompts for the drawer's welcome screen, as strings or { prompt, kind } objects. Leave it unset to use the prompts configured for your agent in Teaflask; any value, even an empty list, replaces them."
+            },
+            {
+              "kind": "field",
+              "name": "toolViews",
+              "type": {
+                "text": "Readonly<Record<string, ToolViewRegistration>> | null | undefined"
+              },
+              "description": "Your own components for displaying specific tools and actions, keyed by tool name (action__<slug> for an action), the same registry as the React toolViews prop. It can be set before or after the element loads and reaches calls already on screen; keys starting with teaflask. and malformed entries are dropped one by one with a console warning."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "teaflask-assistant-page",
+          "declaration": {
+            "name": "TeaflaskAssistantPageElement"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "teaflask-assistant",
+          "declaration": {
+            "name": "TeaflaskAssistantElement"
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/affordances/aria-dropdowns.js

@@ -0,0 +1,315 @@
+import { CLOSE_SETTLE_MS, clicked, OPEN_SETTLE_MS, PICK_SETTLE_MS, pressKey, pressLikeAPointer, settledReading, theClickWouldSubmitOrLeaveThePage, theControlIsInert, } from "./page-gestures.js";
+import { CONTROL_REDRAWN_REASON, CURATED_OPTIONS_REASON, DROPDOWN_NEVER_OPENED_REASON, DROPDOWN_PICK_DID_NOT_LAND_REASON, INERT_FIELD_REASON, MULTI_CHOICE_REASON, NO_OPTIONS_SHOWN_REASON, noMatchingOptionReasonListing, SUBMITTING_CONTROL_REASON, unavailableOptionReason, } from "./prefill-reasons.js";
+import { accessibleNameOf, } from "../reader/accessible-name.js";
+import { ariaBooleanOf, roleOf, theControlIsDisabled, } from "../reader/roles.js";
+import { alreadyShowsTheValue, comboboxOwnerOf, confirmsLabel, displayNamesTheMatch, ownDisplayIsReliable, ownerShowsThePick, shownTextOf, } from "./dropdown-display.js";
+import { _normalizedNodeName } from "../reader/snapshot-node.js";
+import { lastReadIgnoreSelectors } from "../reader/snapshot.js";
+import { theElementSitsInACuratedSubtree } from "../reader/snapshot-root.js";
+import { visibilityOracleOf } from "../reader/visibility.js";
+export async function customDropdownRefusalOf(element, value, probe, listingBudget, whenNoListOpens) {
+    const entryRefusal = _dropdownEntryRefusalOf(element);
+    if (entryRefusal !== null) {
+        return entryRefusal;
+    }
+    const want = value.trim();
+    if (ownDisplayIsReliable(element) &&
+        alreadyShowsTheValue(element, want, probe, null)) {
+        return null;
+    }
+    if (!(element instanceof HTMLInputElement) &&
+        theClickWouldSubmitOrLeaveThePage(element)) {
+        return SUBMITTING_CONTROL_REASON;
+    }
+    const found = await _openedListboxFor(element, probe);
+    const listbox = found.listbox;
+    const closedIfOurs = async () => {
+        if (found.provenance === "ours") {
+            await _closedPopup(element, listbox, probe);
+        }
+    };
+    if (listbox === null) {
+        if (!element.isConnected) {
+            return CONTROL_REDRAWN_REASON;
+        }
+        if (found.gesturesWereDispatched) {
+            await _closedPopup(element, listbox, probe);
+        }
+        return whenNoListOpens !== undefined
+            ? whenNoListOpens(DROPDOWN_NEVER_OPENED_REASON)
+            : DROPDOWN_NEVER_OPENED_REASON;
+    }
+    if (!element.isConnected) {
+        return CONTROL_REDRAWN_REASON;
+    }
+    if (!ownDisplayIsReliable(element) &&
+        alreadyShowsTheValue(element, want, probe, listbox)) {
+        await closedIfOurs();
+        return null;
+    }
+    if (theElementSitsInACuratedSubtree(listbox, lastReadIgnoreSelectors())) {
+        await closedIfOurs();
+        return CURATED_OPTIONS_REASON;
+    }
+    if (ariaBooleanOf(listbox.getAttribute("aria-multiselectable")) === true) {
+        await closedIfOurs();
+        return MULTI_CHOICE_REASON;
+    }
+    const options = _visibleOptionsOf(listbox, probe);
+    if (options.length === 0) {
+        await closedIfOurs();
+        return whenNoListOpens !== undefined
+            ? whenNoListOpens(NO_OPTIONS_SHOWN_REASON)
+            : NO_OPTIONS_SHOWN_REASON;
+    }
+    const cache = new Map();
+    const nameOf = (option) => accessibleNameOf(option, probe, cache).trim();
+    const match = _optionMatching(options, want, value, nameOf);
+    if (match === null) {
+        await closedIfOurs();
+        return _noMatchRefusalOf(element, options, nameOf, listingBudget);
+    }
+    const label = nameOf(match) !== "" ? nameOf(match) : want;
+    if (match.getAttribute("aria-selected") === "true" &&
+        displayNamesTheMatch(shownTextOf(element, probe, listbox), label, options, nameOf)) {
+        await closedIfOurs();
+        return null;
+    }
+    if (theControlIsDisabled(match, "option")) {
+        await closedIfOurs();
+        return unavailableOptionReason(label);
+    }
+    if (theClickWouldSubmitOrLeaveThePage(match)) {
+        await closedIfOurs();
+        return SUBMITTING_CONTROL_REASON;
+    }
+    return _confirmedPickRefusalOf(element, listbox, match, label, probe);
+}
+async function _confirmedPickRefusalOf(element, listbox, match, label, probe) {
+    const beforeText = shownTextOf(element, probe, listbox);
+    clicked(match);
+    const after = await settledReading(() => shownTextOf(element, probe, listbox), (text) => !element.isConnected ||
+        (text !== beforeText && confirmsLabel(text, label)), PICK_SETTLE_MS);
+    await _closedPopup(element, listbox, probe);
+    if (!element.isConnected) {
+        return CONTROL_REDRAWN_REASON;
+    }
+    const landed = after !== beforeText && confirmsLabel(after, label);
+    return landed ? null : DROPDOWN_PICK_DID_NOT_LAND_REASON;
+}
+export async function listboxPickRefusalOf(element, value, probe, listingBudget) {
+    if (theControlIsInert(element)) {
+        return INERT_FIELD_REASON;
+    }
+    if (ariaBooleanOf(element.getAttribute("aria-multiselectable")) === true) {
+        return MULTI_CHOICE_REASON;
+    }
+    const options = _visibleOptionsOf(element, probe);
+    if (options.length === 0) {
+        return NO_OPTIONS_SHOWN_REASON;
+    }
+    const cache = new Map();
+    const nameOf = (option) => accessibleNameOf(option, probe, cache).trim();
+    const want = value.trim();
+    const match = _optionMatching(options, want, value, nameOf);
+    if (match === null) {
+        return _noMatchRefusalOf(element, options, nameOf, listingBudget);
+    }
+    if (match.getAttribute("aria-selected") === "true") {
+        return null;
+    }
+    const label = nameOf(match) !== "" ? nameOf(match) : want;
+    if (theControlIsDisabled(match, "option")) {
+        return unavailableOptionReason(label);
+    }
+    if (theClickWouldSubmitOrLeaveThePage(match)) {
+        return SUBMITTING_CONTROL_REASON;
+    }
+    const owner = comboboxOwnerOf(element);
+    const ownerBefore = owner === null ? "" : shownTextOf(owner, probe, element);
+    clicked(match);
+    const selected = await settledReading(() => match.getAttribute("aria-selected"), (state) => state === "true" || !element.isConnected || !match.isConnected, PICK_SETTLE_MS);
+    if (element.isConnected && match.isConnected) {
+        return selected === "true" ? null : DROPDOWN_PICK_DID_NOT_LAND_REASON;
+    }
+    if (owner !== null) {
+        return (await ownerShowsThePick(owner, ownerBefore, label, probe))
+            ? null
+            : DROPDOWN_PICK_DID_NOT_LAND_REASON;
+    }
+    return CONTROL_REDRAWN_REASON;
+}
+async function _openedListboxFor(element, probe) {
+    if (element.getAttribute("aria-expanded") === "true") {
+        const alreadyOpen = _openedListboxOf(element, probe, new Set(), (candidate) => _popupBelongsToTrigger(candidate, element, probe));
+        return {
+            listbox: alreadyOpen,
+            provenance: alreadyOpen !== null ? "users" : "unattributed",
+            gesturesWereDispatched: false,
+        };
+    }
+    const alreadyShowing = visibilityOracleOf(probe);
+    const before = new Set(Array.from(document.querySelectorAll('[role="listbox"]')).filter((candidate) => alreadyShowing.isVisible(candidate)));
+    if (element instanceof HTMLElement) {
+        element.focus();
+    }
+    pressKey(element, "ArrowDown");
+    const viaKeyboard = await settledReading(() => _openedListboxOf(element, probe, before, () => true), (listbox) => listbox !== null || !element.isConnected, OPEN_SETTLE_MS);
+    if (viaKeyboard !== null) {
+        return {
+            listbox: viaKeyboard,
+            provenance: "ours",
+            gesturesWereDispatched: true,
+        };
+    }
+    if (!element.isConnected ||
+        theClickWouldSubmitOrLeaveThePage(element) ||
+        element.getAttribute("aria-expanded") === "true") {
+        return {
+            listbox: null,
+            provenance: "unattributed",
+            gesturesWereDispatched: true,
+        };
+    }
+    pressLikeAPointer(element);
+    const viaPointer = await settledReading(() => _openedListboxOf(element, probe, before, () => true), (listbox) => listbox !== null || !element.isConnected, OPEN_SETTLE_MS);
+    return {
+        listbox: viaPointer,
+        provenance: viaPointer !== null ? "ours" : "unattributed",
+        gesturesWereDispatched: true,
+    };
+}
+const KINSHIP_CLIMB_MAX = 5;
+function _popupBelongsToTrigger(candidate, trigger, probe) {
+    if (candidate.contains(trigger) || trigger.contains(candidate)) {
+        return true;
+    }
+    const oracle = visibilityOracleOf(probe);
+    const body = trigger.ownerDocument.body;
+    let current = trigger.parentElement;
+    for (let depth = 0; depth < KINSHIP_CLIMB_MAX && current !== null && current !== body; depth++) {
+        const visibleInside = Array.from(current.querySelectorAll('[role="listbox"]')).filter((listbox) => oracle.isVisible(listbox));
+        if (visibleInside.length > 0) {
+            return visibleInside.length === 1 && visibleInside[0] === candidate;
+        }
+        current = current.parentElement;
+    }
+    return false;
+}
+function _openedListboxOf(trigger, probe, before, unlinkedIsOurs) {
+    const oracle = visibilityOracleOf(probe);
+    const byId = _idReferencedListboxOf(trigger, "aria-controls") ??
+        _idReferencedListboxOf(trigger, "aria-owns");
+    if (byId !== null && oracle.isVisible(byId)) {
+        return byId;
+    }
+    const active = _resolvedIdNear(trigger, trigger.getAttribute("aria-activedescendant"));
+    const viaActive = active?.closest('[role="listbox"]') ?? null;
+    if (viaActive !== null && oracle.isVisible(viaActive)) {
+        return viaActive;
+    }
+    for (const candidate of Array.from(document.querySelectorAll('[role="listbox"]'))) {
+        if (!before.has(candidate) &&
+            oracle.isVisible(candidate) &&
+            unlinkedIsOurs(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function _idReferencedListboxOf(trigger, attribute) {
+    const ids = (trigger.getAttribute(attribute) ?? "")
+        .split(/\s+/)
+        .filter((id) => id !== "");
+    for (const id of ids) {
+        const hit = _resolvedIdNear(trigger, id);
+        if (hit === null) {
+            continue;
+        }
+        if (roleOf(hit) === "listbox") {
+            return hit;
+        }
+        const inner = hit.querySelector('[role="listbox"]');
+        if (inner !== null) {
+            return inner;
+        }
+    }
+    return null;
+}
+function _resolvedIdNear(trigger, id) {
+    if (id === null || id === "") {
+        return null;
+    }
+    const root = trigger.getRootNode();
+    if (root instanceof Document || root instanceof ShadowRoot) {
+        return root.getElementById(id);
+    }
+    return document.getElementById(id);
+}
+function _optionMatching(options, want, rawValue, nameOf) {
+    if (want === "") {
+        return null;
+    }
+    return (options.find((option) => nameOf(option) === want) ??
+        options.find((option) => nameOf(option).toLowerCase() === want.toLowerCase()) ??
+        options.find((option) => {
+            const shownToTheModel = _normalizedNodeName(nameOf(option));
+            const comparable = shownToTheModel.trimEnd();
+            return (shownToTheModel !== nameOf(option) &&
+                (comparable === want || comparable.toLowerCase() === want.toLowerCase()));
+        }) ??
+        options.find((option) => option.getAttribute("data-value") === rawValue) ??
+        null);
+}
+function _visibleOptionsOf(listbox, probe) {
+    const oracle = visibilityOracleOf(probe);
+    const ignoreSelectors = lastReadIgnoreSelectors();
+    return Array.from(listbox.querySelectorAll('[role="option"]')).filter((option) => oracle.isVisible(option) &&
+        !theElementSitsInACuratedSubtree(option, ignoreSelectors));
+}
+async function _closedPopup(control, listbox, probe) {
+    if (_popupLooksClosed(control, listbox, probe)) {
+        return;
+    }
+    const active = control.ownerDocument.activeElement;
+    const focused = active !== null &&
+        (control.contains(active) || (listbox?.contains(active) ?? false))
+        ? active
+        : null;
+    if (focused instanceof HTMLInputElement) {
+        focused.blur();
+    }
+    else if (control instanceof HTMLInputElement) {
+        control.blur();
+    }
+    else {
+        pressKey(focused ?? control, "Escape");
+    }
+    await settledReading(() => _popupLooksClosed(control, listbox, probe), (closed) => closed, CLOSE_SETTLE_MS);
+}
+function _popupLooksClosed(control, listbox, probe) {
+    if (!control.isConnected) {
+        return true;
+    }
+    if (control.hasAttribute("aria-expanded")) {
+        return control.getAttribute("aria-expanded") !== "true";
+    }
+    return !_popupShowing(listbox, probe);
+}
+function _popupShowing(listbox, probe) {
+    return (listbox !== null &&
+        listbox.isConnected &&
+        visibilityOracleOf(probe).isVisible(listbox));
+}
+function _dropdownEntryRefusalOf(element) {
+    if (theControlIsInert(element) || theControlIsDisabled(element, "combobox")) {
+        return INERT_FIELD_REASON;
+    }
+    return null;
+}
+function _noMatchRefusalOf(element, options, nameOf, listingBudget) {
+    const labels = options
+        .filter((option) => !theControlIsDisabled(option, "option"))
+        .map(nameOf);
+    return noMatchingOptionReasonListing(labels, listingBudget, element instanceof HTMLInputElement && !element.readOnly);
+}

package/dist/affordances/aria-toggles.js

@@ -0,0 +1,39 @@
+import { clicked, settledReading, theClickWouldSubmitOrLeaveThePage, theControlIsInert, TOGGLE_SETTLE_MS, } from "./page-gestures.js";
+import { CHECKBOX_VALUE_REASON, CHECKED_STATE_UNKNOWN_REASON, CONTROL_REDRAWN_REASON, INERT_FIELD_REASON, RADIO_VALUE_REASON, SUBMITTING_CONTROL_REASON, VALUE_DID_NOT_LAND_REASON, } from "./prefill-reasons.js";
+import { roleOf } from "../reader/roles.js";
+export async function ariaToggleRefusalOf(element, value) {
+    if (roleOf(element) === "radio" && value !== "true") {
+        return RADIO_VALUE_REASON;
+    }
+    if (value !== "true" && value !== "false") {
+        return CHECKBOX_VALUE_REASON;
+    }
+    if (theControlIsInert(element)) {
+        return INERT_FIELD_REASON;
+    }
+    const state = _rawCheckedOf(element);
+    if (state === null) {
+        return CHECKED_STATE_UNKNOWN_REASON;
+    }
+    if (state === value) {
+        return null;
+    }
+    if (theClickWouldSubmitOrLeaveThePage(element)) {
+        return SUBMITTING_CONTROL_REASON;
+    }
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const before = _rawCheckedOf(element);
+        clicked(element);
+        const after = await settledReading(() => _rawCheckedOf(element), (read) => read === value || !element.isConnected, TOGGLE_SETTLE_MS);
+        if (after === value || after === before) {
+            break;
+        }
+    }
+    if (!element.isConnected) {
+        return CONTROL_REDRAWN_REASON;
+    }
+    return _rawCheckedOf(element) === value ? null : VALUE_DID_NOT_LAND_REASON;
+}
+function _rawCheckedOf(element) {
+    return element.getAttribute("aria-checked")?.toLowerCase() ?? null;
+}