@agent-native/toolkit 0.9.1 → 0.10.1

package/dist/conformance/conformance.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.spec.d.ts","sourceRoot":"","sources":["../../src/conformance/conformance.spec.tsx"],"names":[],"mappings":""}

package/dist/conformance/conformance.spec.js

@@ -0,0 +1,87 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { defaultDesignSystemComponents } from "../design-system/default-adapter.js";
+import { DESIGN_SYSTEM_CONTRACT_VERSION, } from "../design-system/types.js";
+import { cssInJsFixtureAdapter } from "./__fixtures__/css-in-js-adapter.js";
+import { assertDesignSystemConformance, DESIGN_SYSTEM_CONFORMANCE_CHECKS, runDesignSystemConformance, } from "./runner.js";
+import { assertDesignSystemContractVersion, DESIGN_SYSTEM_CONTRACT_EVOLUTION_POLICY, } from "./version.js";
+class ResizeObserverStub {
+    observe() { }
+    unobserve() { }
+    disconnect() { }
+}
+describe("design-system conformance kit", () => {
+    beforeEach(() => {
+        vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", false);
+        vi.stubGlobal("ResizeObserver", ResizeObserverStub);
+        HTMLElement.prototype.scrollIntoView = vi.fn();
+        HTMLElement.prototype.hasPointerCapture = vi.fn(() => false);
+        HTMLElement.prototype.setPointerCapture = vi.fn();
+        HTMLElement.prototype.releasePointerCapture = vi.fn();
+    });
+    afterEach(() => {
+        document.body.replaceChildren();
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    it("publishes named coverage for all seventeen components and overlay concerns", () => {
+        const covered = new Set(DESIGN_SYSTEM_CONFORMANCE_CHECKS.flatMap((check) => check.components));
+        expect(covered.size).toBe(17);
+        expect(DESIGN_SYSTEM_CONFORMANCE_CHECKS.map((check) => check.id)).toEqual(expect.arrayContaining([
+            "overlay.portal-and-z-index-stacking",
+            "overlay.focus-interoperability",
+        ]));
+    });
+    it("enforces the published contract evolution policy", () => {
+        expect(DESIGN_SYSTEM_CONTRACT_EVOLUTION_POLICY.minor).toContain("optional props");
+        expect(DESIGN_SYSTEM_CONTRACT_EVOLUTION_POLICY.major).toContain("behavioral");
+        expect(() => assertDesignSystemContractVersion(DESIGN_SYSTEM_CONTRACT_VERSION)).not.toThrow();
+        expect(() => assertDesignSystemContractVersion(2)).toThrow(/incompatible/);
+    });
+    it("passes the styling-independent CSS-in-JS fixture", async () => {
+        const report = await assertDesignSystemConformance({
+            adapterName: "CSS-in-JS fixture",
+            components: cssInJsFixtureAdapter,
+            contractVersion: DESIGN_SYSTEM_CONTRACT_VERSION,
+        });
+        expect(report.passed).toBe(true);
+    });
+    it("passes the default shadcn and Radix adapter", async () => {
+        const report = await runDesignSystemConformance({
+            adapterName: "Toolkit default",
+            components: defaultDesignSystemComponents,
+            contractVersion: DESIGN_SYSTEM_CONTRACT_VERSION,
+        });
+        expect(report.results.filter((result) => !result.passed)).toEqual([]);
+    });
+    it("rejects tabs that stack an icon above its label", async () => {
+        const stackedTabsAdapter = {
+            ...cssInJsFixtureAdapter,
+            Tabs: ({ items, value, onChange, orientation }) => (_jsxs("div", { children: [_jsx("div", { role: "tablist", "aria-orientation": orientation, children: items.map((item) => (_jsxs("button", { role: "tab", "aria-selected": item.value === value, style: { display: "flex", flexDirection: "column" }, onClick: () => onChange(item.value), children: [item.icon, item.label] }, String(item.value)))) }), items.find((item) => item.value === value)?.content] })),
+        };
+        const report = await runDesignSystemConformance({
+            adapterName: "stacked-tabs fixture",
+            components: stackedTabsAdapter,
+            contractVersion: DESIGN_SYSTEM_CONTRACT_VERSION,
+        });
+        const tabsResult = report.results.find((result) => result.id === "behavior.tabs");
+        expect(tabsResult?.passed).toBe(false);
+        expect(tabsResult?.message).toContain("same row");
+    });
+    it("rejects dialogs that render footer controls outside the dialog", async () => {
+        const detachedFooterAdapter = {
+            ...cssInJsFixtureAdapter,
+            Dialog: ({ footer, ...props }) => (_jsxs(_Fragment, { children: [_jsx(cssInJsFixtureAdapter.Dialog, { ...props }), footer] })),
+        };
+        const report = await runDesignSystemConformance({
+            adapterName: "detached-footer fixture",
+            components: detachedFooterAdapter,
+            contractVersion: DESIGN_SYSTEM_CONTRACT_VERSION,
+        });
+        const dialogResult = report.results.find((result) => result.id === "behavior.dialog");
+        expect(dialogResult?.passed).toBe(false);
+        expect(dialogResult?.message).toContain("footer");
+    });
+});
+//# sourceMappingURL=conformance.spec.js.map

package/dist/conformance/conformance.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.spec.js","sourceRoot":"","sources":["../../src/conformance/conformance.spec.tsx"],"names":[],"mappings":"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"}

package/dist/conformance/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./runner.js";
+export * from "./types.js";
+export * from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/conformance/index.js

@@ -0,0 +1,4 @@
+export * from "./runner.js";
+export * from "./types.js";
+export * from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/conformance/runner.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+import type { DesignSystemComponents } from "../design-system/types.js";
+import type { DesignSystemConformanceCategory, DesignSystemConformanceReport, RunDesignSystemConformanceOptions } from "./types.js";
+export declare const DESIGN_SYSTEM_CONFORMANCE_CHECKS: {
+    id: string;
+    category: DesignSystemConformanceCategory;
+    components: readonly (keyof DesignSystemComponents)[];
+}[];
+export declare function runDesignSystemConformance({ adapterName, components, contractVersion, document: suppliedDocument, }: RunDesignSystemConformanceOptions): Promise<DesignSystemConformanceReport>;
+export declare function assertDesignSystemConformance(options: RunDesignSystemConformanceOptions): Promise<DesignSystemConformanceReport>;
+export declare function renderDesignSystemConformanceFixture(components: DesignSystemComponents): ReactNode;
+//# sourceMappingURL=runner.d.ts.map

package/dist/conformance/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/conformance/runner.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAKf,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EACV,+BAA+B,EAE/B,6BAA6B,EAC7B,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAssBpB,eAAO,MAAM,gCAAgC;;;;GAE5C,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,EAC/C,WAA8B,EAC9B,UAAU,EACV,eAAe,EACf,QAAQ,EAAE,gBAAgB,GAC3B,EAAE,iCAAiC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAyG5E;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,6BAA6B,CAAC,CAOxC;AAED,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,sBAAsB,GACjC,SAAS,CAKX"}

package/dist/conformance/runner.js

@@ -0,0 +1,515 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createElement, useRef, useState, } from "react";
+import { flushSync } from "react-dom";
+import { createRoot } from "react-dom/client";
+import { DESIGN_SYSTEM_CONTRACT_VERSION } from "../design-system/types.js";
+import { assertDesignSystemContractVersion } from "./version.js";
+const contractComponentNames = [
+    "ActionButton",
+    "IconButton",
+    "TextField",
+    "TextArea",
+    "Spinner",
+    "Skeleton",
+    "Status",
+    "Surface",
+    "Avatar",
+    "Tooltip",
+    "Menu",
+    "Popover",
+    "Dialog",
+    "Picker",
+    "Checkbox",
+    "Switch",
+    "Tabs",
+];
+function invariant(value, message) {
+    if (!value)
+        throw new Error(message);
+}
+function dispatch(element, event) {
+    flushSync(() => element.dispatchEvent(event));
+}
+function click(element, document) {
+    for (const type of ["pointerdown", "mousedown"]) {
+        dispatch(element, new document.defaultView.MouseEvent(type, {
+            bubbles: true,
+            cancelable: true,
+            button: 0,
+        }));
+    }
+    dispatch(element, new document.defaultView.MouseEvent("click", {
+        bubbles: true,
+        cancelable: true,
+        button: 0,
+    }));
+}
+function keydown(element, key, document) {
+    dispatch(element, new document.defaultView.KeyboardEvent("keydown", {
+        key,
+        bubbles: true,
+        cancelable: true,
+    }));
+}
+function input(element, value) {
+    const prototype = element instanceof element.ownerDocument.defaultView.HTMLTextAreaElement
+        ? element.ownerDocument.defaultView.HTMLTextAreaElement.prototype
+        : element.ownerDocument.defaultView.HTMLInputElement.prototype;
+    Object.getOwnPropertyDescriptor(prototype, "value")?.set?.call(element, value);
+    dispatch(element, new element.ownerDocument.defaultView.Event("input", {
+        bubbles: true,
+        cancelable: true,
+    }));
+}
+function elementWithText(document, selector, text) {
+    return [...document.querySelectorAll(selector)].find((element) => element.textContent?.includes(text));
+}
+function assertInlineLayout(container, iconSelector, labelSelector, message) {
+    const icon = container.querySelector(iconSelector);
+    const label = container.querySelector(labelSelector);
+    invariant(icon && label, message);
+    const iconRect = icon.getBoundingClientRect();
+    const labelRect = label.getBoundingClientRect();
+    const hasGeometry = iconRect.width > 0 ||
+        iconRect.height > 0 ||
+        labelRect.width > 0 ||
+        labelRect.height > 0;
+    if (hasGeometry) {
+        const verticalOverlap = Math.min(iconRect.bottom, labelRect.bottom) -
+            Math.max(iconRect.top, labelRect.top);
+        invariant(verticalOverlap > 0 || Math.abs(iconRect.top - labelRect.top) <= 2, message);
+        return;
+    }
+    // happy-dom does not calculate layout. Still reject adapters that explicitly
+    // stack the tab contents, while browser-backed runs use the geometry check.
+    const commonAncestor = (() => {
+        let candidate = icon;
+        while (candidate && !candidate.contains(label)) {
+            candidate = candidate.parentElement;
+        }
+        return candidate;
+    })();
+    const styles = [
+        container,
+        commonAncestor,
+        icon.parentElement,
+        label.parentElement,
+    ]
+        .filter((element) => Boolean(element))
+        .map((element) => element.ownerDocument.defaultView?.getComputedStyle(element));
+    invariant(!styles.some((style) => style?.display === "flex" && style.flexDirection === "column"), message);
+}
+function assertContainedFooter(dialog, footerSelector) {
+    const footer = dialog.querySelector(footerSelector);
+    invariant(footer, "Dialog footer controls must be rendered inside the dialog surface.");
+    const dialogRect = dialog.getBoundingClientRect();
+    const footerRect = footer.getBoundingClientRect();
+    const hasGeometry = dialogRect.width > 0 ||
+        dialogRect.height > 0 ||
+        footerRect.width > 0 ||
+        footerRect.height > 0;
+    if (!hasGeometry)
+        return;
+    const epsilon = 2;
+    invariant(footerRect.top >= dialogRect.top - epsilon &&
+        footerRect.bottom <= dialogRect.bottom + epsilon &&
+        footerRect.left >= dialogRect.left - epsilon &&
+        footerRect.right <= dialogRect.right + epsilon, "Dialog footer controls must remain within the dialog surface bounds.");
+}
+const checks = [
+    {
+        id: "contract.components",
+        category: "contract",
+        components: contractComponentNames,
+        run: ({ components }) => {
+            for (const name of contractComponentNames) {
+                invariant(typeof components[name] === "function", `${name} must be supplied as a React component.`);
+            }
+        },
+    },
+    {
+        id: "leaf.action-button",
+        category: "leaf",
+        components: ["ActionButton"],
+        run: ({ components, document, mount, unmount }) => {
+            let presses = 0;
+            const probe = mount(_jsx(components.ActionButton, { intent: "danger", emphasis: "outline", size: "compact", onPress: () => presses++, children: "Remove" }));
+            const button = probe.container.querySelector("button");
+            invariant(button, "ActionButton must render an operable button.");
+            click(button, document);
+            invariant(presses === 1, "ActionButton must call onPress once.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "leaf.icon-button",
+        category: "leaf",
+        components: ["IconButton"],
+        run: ({ components, document, mount, unmount }) => {
+            let presses = 0;
+            const probe = mount(_jsx(components.IconButton, { label: "Close panel", icon: _jsx("span", { "aria-hidden": "true", children: "x" }), onPress: () => presses++ }));
+            const button = probe.container.querySelector('button[aria-label="Close panel"]');
+            invariant(button, "IconButton must expose its label as an accessible name.");
+            click(button, document);
+            invariant(presses === 1, "IconButton must call onPress once.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "leaf.text-field",
+        category: "leaf",
+        components: ["TextField"],
+        run: ({ components, mount, unmount }) => {
+            let value = "";
+            const probe = mount(_jsx(components.TextField, { "aria-label": "Project name", value: value, onChange: (next) => (value = next) }));
+            const field = probe.container.querySelector("input");
+            invariant(field, "TextField must render an input.");
+            input(field, "Atlas");
+            invariant(value === "Atlas", "TextField must report string values.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "leaf.text-area",
+        category: "leaf",
+        components: ["TextArea"],
+        run: ({ components, mount, unmount }) => {
+            let value = "";
+            const probe = mount(_jsx(components.TextArea, { "aria-label": "Notes", value: value, onChange: (next) => (value = next) }));
+            const field = probe.container.querySelector("textarea");
+            invariant(field, "TextArea must render a textarea.");
+            input(field, "Conformant");
+            invariant(value === "Conformant", "TextArea must report string values.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "leaf.progress-and-placeholder",
+        category: "leaf",
+        components: ["Spinner", "Skeleton"],
+        run: ({ components, mount, unmount }) => {
+            const probe = mount(_jsxs(_Fragment, { children: [_jsx(components.Spinner, { label: "Loading records", size: "compact" }), _jsx(components.Skeleton, { width: 48, height: 12, shape: "line" })] }));
+            invariant(probe.container.querySelector('[role="status"]'), "A labeled Spinner must expose status semantics.");
+            invariant(probe.container.querySelector('[aria-hidden="true"]'), "Skeleton must be hidden from assistive technology.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "leaf.status-surface-avatar",
+        category: "leaf",
+        components: ["Status", "Surface", "Avatar"],
+        run: ({ components, document, mount, unmount }) => {
+            let presses = 0;
+            const probe = mount(_jsxs(_Fragment, { children: [_jsx(components.Status, { tone: "success", children: "Connected" }), _jsx(components.Surface, { interactive: true, onPress: () => presses++, children: "Open workspace" }), _jsx(components.Avatar, { name: "Ada Lovelace", fallback: "AL" })] }));
+            invariant(probe.container.textContent?.includes("Connected"), "Status must render its content.");
+            const surface = elementWithText(document, '[role="button"]', "Open workspace");
+            invariant(surface, "An interactive Surface must expose button semantics.");
+            keydown(surface, "Enter", document);
+            invariant(presses === 1, "An interactive Surface must support keyboard press.");
+            invariant(probe.container.textContent?.includes("AL"), "Avatar must render a fallback when no image is supplied.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "behavior.tooltip",
+        category: "behavior",
+        components: ["Tooltip"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            const portal = document.createElement("div");
+            portal.dataset.conformancePortal = "true";
+            document.body.appendChild(portal);
+            const probe = mount(_jsx(components.Tooltip, { trigger: _jsx("button", { children: "Help" }), content: "Helpful context", open: true, portalContainer: portal }));
+            await settle();
+            invariant(portal.textContent?.includes("Helpful context"), "Tooltip must honor controlled open and portalContainer.");
+            unmount(probe);
+            const defaultOpenProbe = mount(_jsx(components.Tooltip, { trigger: _jsx("button", { children: "Help by default" }), content: "Default tooltip", defaultOpen: true, portalContainer: portal }));
+            await settle();
+            invariant(portal.textContent?.includes("Default tooltip"), "Tooltip must honor defaultOpen and portalContainer.");
+            unmount(defaultOpenProbe);
+            portal.remove();
+        },
+    },
+    {
+        id: "behavior.menu",
+        category: "behavior",
+        components: ["Menu"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            let selected;
+            const probe = mount(_jsx(components.Menu, { trigger: _jsx("button", { children: "Actions" }), items: [{ id: "archive", label: "Archive" }], open: true, onAction: (id) => (selected = id) }));
+            await settle();
+            const item = elementWithText(document, '[role="menuitem"]', "Archive");
+            invariant(item, "Menu must render open items with menuitem semantics.");
+            click(item, document);
+            invariant(selected === "archive", "Menu must report selected item ids.");
+            unmount(probe);
+            const defaultOpenProbe = mount(_jsx(components.Menu, { trigger: _jsx("button", { children: "Default actions" }), items: [{ id: "restore", label: "Restore" }], defaultOpen: true, onAction: () => { } }));
+            await settle();
+            invariant(elementWithText(document, '[role="menuitem"]', "Restore"), "Menu must honor defaultOpen.");
+            unmount(defaultOpenProbe);
+        },
+    },
+    {
+        id: "behavior.popover",
+        category: "behavior",
+        components: ["Popover"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            const portal = document.createElement("div");
+            portal.dataset.conformancePortal = "true";
+            document.body.appendChild(portal);
+            const probe = mount(_jsx(components.Popover, { trigger: _jsx("button", { children: "Details" }), open: true, portalContainer: portal, children: "Popover details" }));
+            await settle();
+            invariant(portal.textContent?.includes("Popover details"), "Popover must honor controlled open and portalContainer.");
+            unmount(probe);
+            portal.remove();
+        },
+    },
+    {
+        id: "behavior.dialog",
+        category: "behavior",
+        components: ["Dialog"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            const portal = document.createElement("div");
+            portal.dataset.conformancePortal = "true";
+            document.body.appendChild(portal);
+            const probe = mount(_jsx(components.Dialog, { open: true, onOpenChange: () => { }, title: "Edit project", dismissible: false, portalContainer: portal, children: _jsx("input", { "aria-label": "Project title" }) }));
+            await settle();
+            invariant(portal.querySelector('[role="dialog"]'), "Dialog must expose dialog semantics.");
+            invariant(portal.textContent?.includes("Edit project"), "Dialog must expose its title and honor portalContainer.");
+            invariant(portal.querySelector('[role="dialog"]')?.querySelectorAll("button")
+                .length === 0, "Dialog must not invent actions when footer is omitted.");
+            unmount(probe);
+            const footerProbe = mount(_jsx(components.Dialog, { open: true, onOpenChange: () => { }, title: "Footer probe", portalContainer: portal, footer: _jsx("button", { "data-conformance-dialog-footer-action": "true", type: "button", children: "Save" }), children: "Footer content" }));
+            await settle();
+            const footerDialog = portal.querySelector('[role="dialog"]');
+            invariant(footerDialog, "Dialog footer probe did not render a dialog.");
+            assertContainedFooter(footerDialog, '[data-conformance-dialog-footer-action="true"]');
+            unmount(footerProbe);
+            portal.remove();
+        },
+    },
+    {
+        id: "behavior.picker",
+        category: "behavior",
+        components: ["Picker"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            let value = null;
+            const probe = mount(_jsx(components.Picker, { mode: "select", "aria-label": "Owner", options: [{ value: "ada", label: "Ada" }], value: value, onChange: (next) => (value = next), open: true }));
+            await settle();
+            const option = elementWithText(document, '[role="option"]', "Ada");
+            invariant(option, "An open Picker must expose options.");
+            click(option, document);
+            invariant(value === "ada", "Picker must report option values.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "behavior.checkbox-switch",
+        category: "behavior",
+        components: ["Checkbox", "Switch"],
+        run: ({ components, document, mount, unmount }) => {
+            let checked = false;
+            let switched = false;
+            const probe = mount(_jsxs(_Fragment, { children: [_jsx(components.Checkbox, { "aria-label": "Include archived", checked: checked, onChange: (next) => (checked = next) }), _jsx(components.Switch, { "aria-label": "Notifications", checked: switched, onChange: (next) => (switched = next) })] }));
+            const checkbox = probe.container.querySelector('[role="checkbox"]');
+            const toggle = probe.container.querySelector('[role="switch"]');
+            invariant(checkbox, "Checkbox must expose checkbox semantics.");
+            invariant(toggle, "Switch must expose switch semantics.");
+            click(checkbox, document);
+            click(toggle, document);
+            invariant(checked && switched, "Checkbox and Switch must report state changes.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "behavior.tabs",
+        category: "behavior",
+        components: ["Tabs"],
+        run: ({ components, document, mount, unmount }) => {
+            let value = "first";
+            const probe = mount(_jsx(components.Tabs, { value: value, orientation: "vertical", onChange: (next) => (value = next), items: [
+                    {
+                        value: "first",
+                        label: _jsx("span", { "data-conformance-tab-label": "true", children: "First" }),
+                        icon: (_jsx("span", { "data-conformance-tab-icon": "true", "aria-hidden": "true", children: "\u25CF" })),
+                        content: "One",
+                    },
+                    { value: "second", label: "Second", content: "Two" },
+                ] }));
+            const tabList = probe.container.querySelector('[role="tablist"]');
+            invariant(tabList, "Tabs must expose a tablist.");
+            invariant(tabList.getAttribute("aria-orientation") === "vertical", "Tabs must honor vertical orientation in their tablist semantics.");
+            const first = elementWithText(document, '[role="tab"]', "First");
+            invariant(first, "Tabs must expose the icon-bearing tab.");
+            assertInlineLayout(first, '[data-conformance-tab-icon="true"]', '[data-conformance-tab-label="true"]', "Tabs must lay out an icon and its label on the same row.");
+            const second = elementWithText(document, '[role="tab"]', "Second");
+            invariant(second, "Tabs must expose tab semantics.");
+            click(second, document);
+            invariant(value === "second", "Tabs must report selected values.");
+            unmount(probe);
+        },
+    },
+    {
+        id: "overlay.portal-and-z-index-stacking",
+        category: "overlay-interoperability",
+        components: ["Dialog"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            const radixHost = document.createElement("div");
+            radixHost.dataset.hostedOverlay = "radix";
+            radixHost.dataset.conformancePortal = "true";
+            radixHost.style.zIndex = "40";
+            document.body.appendChild(radixHost);
+            const customerOverlayLayer = document.createElement("div");
+            customerOverlayLayer.dataset.designSystemOverlayLayer = "true";
+            customerOverlayLayer.dataset.conformancePortal = "true";
+            customerOverlayLayer.style.position = "relative";
+            customerOverlayLayer.style.zIndex = "50";
+            document.body.appendChild(customerOverlayLayer);
+            const probe = mount(_jsx(components.Dialog, { open: true, onOpenChange: () => { }, title: "Stacking probe", portalContainer: customerOverlayLayer, children: "Overlay content" }));
+            await settle();
+            invariant(customerOverlayLayer.querySelector('[role="dialog"]'), "Behavior adapters must portal into the supplied stacking layer so they can interoperate with Radix-hosted surfaces.");
+            invariant(Number(customerOverlayLayer.style.zIndex) >
+                Number(radixHost.style.zIndex), "The supplied design-system portal layer must be able to stack above an existing hosted overlay.");
+            unmount(probe);
+            customerOverlayLayer.remove();
+            radixHost.remove();
+        },
+    },
+    {
+        id: "overlay.focus-interoperability",
+        category: "overlay-interoperability",
+        components: ["Dialog"],
+        run: async ({ components, document, mount, settle, unmount }) => {
+            function FocusProbe() {
+                const [open, setOpen] = useState(true);
+                const initialFocusRef = useRef(null);
+                const restoreFocusRef = useRef(null);
+                return (_jsxs(_Fragment, { children: [_jsx("button", { ref: restoreFocusRef, children: "Hosted trigger" }), _jsxs(components.Dialog, { open: open, onOpenChange: setOpen, title: "Focus probe", initialFocusRef: initialFocusRef, restoreFocusRef: restoreFocusRef, children: [_jsx("input", { ref: initialFocusRef, "aria-label": "Initial focus" }), _jsx("button", { onClick: () => setOpen(false), children: "Close probe" })] })] }));
+            }
+            const probe = mount(_jsx(FocusProbe, {}));
+            await settle();
+            const initial = document.querySelector('input[aria-label="Initial focus"]');
+            invariant(initial, "Dialog must render its initial focus target.");
+            invariant(document.activeElement === initial, "Dialog must honor initialFocusRef across adapter overlay implementations.");
+            const close = elementWithText(document, "button", "Close probe");
+            invariant(close, "Focus probe close control did not render.");
+            click(close, document);
+            await settle();
+            invariant(document.activeElement?.textContent === "Hosted trigger", "Dialog must restore focus to a hosted trigger after its native overlay closes.");
+            unmount(probe);
+        },
+    },
+];
+export const DESIGN_SYSTEM_CONFORMANCE_CHECKS = checks.map(({ id, category, components }) => ({ id, category, components }));
+export async function runDesignSystemConformance({ adapterName = "custom adapter", components, contractVersion, document: suppliedDocument, }) {
+    const document = suppliedDocument ?? globalThis.document;
+    if (!document?.body || !document.defaultView) {
+        throw new Error("runDesignSystemConformance requires a browser-like document, such as Playwright, jsdom, or happy-dom.");
+    }
+    const results = [];
+    try {
+        assertDesignSystemContractVersion(contractVersion);
+        results.push({
+            id: "contract.version-policy",
+            category: "contract",
+            components: [],
+            passed: true,
+        });
+    }
+    catch (error) {
+        results.push({
+            id: "contract.version-policy",
+            category: "contract",
+            components: [],
+            passed: false,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const mounted = new Set();
+    const exercisedComponents = new Set();
+    const trackedComponents = new Proxy(components, {
+        get(target, property, receiver) {
+            if (typeof property === "string" && property in target) {
+                exercisedComponents.add(property);
+            }
+            return Reflect.get(target, property, receiver);
+        },
+    });
+    const context = {
+        components: trackedComponents,
+        document,
+        mount(element) {
+            const container = document.createElement("div");
+            container.dataset.conformanceRoot = "true";
+            document.body.appendChild(container);
+            const root = createRoot(container);
+            const probe = { container, root };
+            mounted.add(probe);
+            flushSync(() => root.render(element));
+            return probe;
+        },
+        unmount(probe) {
+            if (!mounted.delete(probe))
+                return;
+            flushSync(() => probe.root.unmount());
+            probe.container.remove();
+        },
+        async settle() {
+            await new Promise((resolve) => document.defaultView.setTimeout(resolve, 0));
+        },
+    };
+    for (const check of checks) {
+        try {
+            exercisedComponents.clear();
+            await check.run(context);
+            const missingComponents = check.components.filter((component) => !exercisedComponents.has(component));
+            invariant(missingComponents.length === 0, `Conformance check ${check.id} declared ${missingComponents.join(", ")} but did not exercise them.`);
+            results.push({
+                id: check.id,
+                category: check.category,
+                components: check.components,
+                passed: true,
+            });
+        }
+        catch (error) {
+            results.push({
+                id: check.id,
+                category: check.category,
+                components: check.components,
+                passed: false,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+        finally {
+            for (const probe of [...mounted])
+                context.unmount(probe);
+            document
+                .querySelectorAll("[data-radix-popper-content-wrapper]")
+                .forEach((element) => element.remove());
+            document
+                .querySelectorAll('[data-conformance-portal="true"]')
+                .forEach((element) => element.remove());
+        }
+    }
+    const report = {
+        adapterName,
+        contractVersion: DESIGN_SYSTEM_CONTRACT_VERSION,
+        passed: results.every((result) => result.passed),
+        results,
+    };
+    return report;
+}
+export async function assertDesignSystemConformance(options) {
+    const report = await runDesignSystemConformance(options);
+    if (!report.passed) {
+        const { DesignSystemConformanceError } = await import("./types.js");
+        throw new DesignSystemConformanceError(report);
+    }
+    return report;
+}
+export function renderDesignSystemConformanceFixture(components) {
+    return createElement(components.Status, {
+        tone: "info",
+        children: "Adapter loaded",
+    });
+}
+//# sourceMappingURL=runner.js.map