@gtkx/testing 1.0.0-rc.3 → 1.0.0

package/dist/query-helpers.js

@@ -0,0 +1,57 @@
+import { camelCase } from "@gtkx/utils";
+import { buildQueries } from "./build-queries.js";
+import { getElementError } from "./errors.js";
+import { isMatchingWidgetType, isTextMatch } from "./queries.js";
+import { findAll } from "./traversal.js";
+/** The query-building helpers, bundled so they can be reached under a single import. */
+const queryHelpers = {
+    buildQueries,
+    getElementError,
+    queryAllByObjectProperty,
+    queryByObjectProperty,
+};
+const readObjectProperty = (widget, property) => {
+    const value = Reflect.get(widget, camelCase(property));
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+        return String(value);
+    }
+    return null;
+};
+/**
+ * Finds every widget carrying a GObject property whose value matches, the counterpart of DOM Testing
+ * Library's `queryAllByAttribute`. The property name may be given in kebab-case or camelCase, and
+ * widgets that are not mapped are never matched.
+ *
+ * @param property Name of the GObject property to read.
+ * @param container Widget subtree to search.
+ * @param text Matcher for the property's value.
+ * @param options Text matching options.
+ * @returns Every matching widget, or an empty array when none match.
+ */
+function queryAllByObjectProperty(property, container, text, options) {
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) &&
+        isTextMatch(readObjectProperty(widget, property), text, widget, options));
+}
+/**
+ * Returns the single widget carrying a GObject property whose value matches, or null when none do,
+ * the counterpart of DOM Testing Library's `queryByAttribute`.
+ *
+ * @param property Name of the GObject property to read.
+ * @param container Widget subtree to search.
+ * @param text Matcher for the property's value.
+ * @param options Text matching options.
+ * @returns The matching widget, or null when none match.
+ * @throws When more than one widget matches.
+ */
+function queryByObjectProperty(property, container, text, options) {
+    const matches = queryAllByObjectProperty(property, container, text, options);
+    if (matches.length > 1) {
+        throw getElementError(`Found ${String(matches.length)} elements with the '${property}' property, but expected only one`, container);
+    }
+    return matches[0] ?? null;
+}
+export { queryAllByObjectProperty, queryByObjectProperty, queryHelpers };
+//# sourceMappingURL=query-helpers.js.map

package/dist/query-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-helpers.js","sourceRoot":"","sources":["../src/query-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAkB,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAczD,wFAAwF;AACxF,MAAM,YAAY,GAAiB;IAC/B,YAAY;IACZ,eAAe;IACf,wBAAwB;IACxB,qBAAqB;CACxB,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAE,QAAgB,EAAiB,EAAE;IAC/E,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEhE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAS,wBAAwB,CAC7B,QAAgB,EAChB,SAAoB,EACpB,IAAa,EACb,OAAwB;IAExB,OAAO,OAAO,CACV,SAAS,EACT,CAAC,MAAM,EAAE,EAAE,CACP,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC;QACrC,WAAW,CAAC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAC/E,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,qBAAqB,CAC1B,QAAgB,EAChB,SAAoB,EACpB,IAAa,EACb,OAAwB;IAExB,MAAM,OAAO,GAAG,wBAAwB,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,eAAe,CACjB,SAAS,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,uBAAuB,QAAQ,mCAAmC,EACjG,SAAS,CACZ,CAAC;IACN,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,YAAY,EAAqB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { camelCase } from \"@gtkx/utils\";\nimport type { Matcher, MatcherOptions } from \"./types.js\";\nimport { buildQueries } from \"./build-queries.js\";\nimport { getElementError } from \"./errors.js\";\nimport { isMatchingWidgetType, isTextMatch } from \"./queries.js\";\nimport { type Container, findAll } from \"./traversal.js\";\n\n/** The helpers used to build custom queries, bundled the way DOM Testing Library exposes them. */\ntype QueryHelpers = {\n    /** Derives a query family's variants from its `queryAllBy` function. */\n    buildQueries: typeof buildQueries;\n    /** Builds the error a failing query throws. */\n    getElementError: typeof getElementError;\n    /** Finds every widget whose GObject property matches. */\n    queryAllByObjectProperty: typeof queryAllByObjectProperty;\n    /** Finds the single widget whose GObject property matches. */\n    queryByObjectProperty: typeof queryByObjectProperty;\n};\n\n/** The query-building helpers, bundled so they can be reached under a single import. */\nconst queryHelpers: QueryHelpers = {\n    buildQueries,\n    getElementError,\n    queryAllByObjectProperty,\n    queryByObjectProperty,\n};\n\nconst readObjectProperty = (widget: Gtk.Widget, property: string): string | null => {\n    const value: unknown = Reflect.get(widget, camelCase(property));\n\n    if (typeof value === \"string\") {\n        return value;\n    }\n\n    if (typeof value === \"number\" || typeof value === \"boolean\" || typeof value === \"bigint\") {\n        return String(value);\n    }\n\n    return null;\n};\n\n/**\n * Finds every widget carrying a GObject property whose value matches, the counterpart of DOM Testing\n * Library's `queryAllByAttribute`. The property name may be given in kebab-case or camelCase, and\n * widgets that are not mapped are never matched.\n *\n * @param property Name of the GObject property to read.\n * @param container Widget subtree to search.\n * @param text Matcher for the property's value.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByObjectProperty(\n    property: string,\n    container: Container,\n    text: Matcher,\n    options?: MatcherOptions,\n): Gtk.Widget[] {\n    return findAll(\n        container,\n        (widget) =>\n            isMatchingWidgetType(widget, options) &&\n            isTextMatch(readObjectProperty(widget, property), text, widget, options),\n    );\n}\n\n/**\n * Returns the single widget carrying a GObject property whose value matches, or null when none do,\n * the counterpart of DOM Testing Library's `queryByAttribute`.\n *\n * @param property Name of the GObject property to read.\n * @param container Widget subtree to search.\n * @param text Matcher for the property's value.\n * @param options Text matching options.\n * @returns The matching widget, or null when none match.\n * @throws When more than one widget matches.\n */\nfunction queryByObjectProperty(\n    property: string,\n    container: Container,\n    text: Matcher,\n    options?: MatcherOptions,\n): Gtk.Widget | null {\n    const matches = queryAllByObjectProperty(property, container, text, options);\n\n    if (matches.length > 1) {\n        throw getElementError(\n            `Found ${String(matches.length)} elements with the '${property}' property, but expected only one`,\n            container,\n        );\n    }\n\n    return matches[0] ?? null;\n}\n\nexport { queryAllByObjectProperty, queryByObjectProperty, queryHelpers, type QueryHelpers };\n"]}

package/dist/render-children.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import type { RenderOptions } from "./types.js";
+type ChildrenBuilder<T> = (items: T[]) => ReactNode;
+type RenderChildrenResult<T> = {
+    rerender: (items: T[]) => Promise<void>;
+};
+declare function renderChildren<T>(initial: T[], build: ChildrenBuilder<T>, options?: RenderOptions): Promise<RenderChildrenResult<T>>;
+export { renderChildren, type ChildrenBuilder };
+//# sourceMappingURL=render-children.d.ts.map

package/dist/render-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-children.d.ts","sourceRoot":"","sources":["../src/render-children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;AAEpD,KAAK,oBAAoB,CAAC,CAAC,IAAI;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC;AAEF,iBAAe,cAAc,CAAC,CAAC,EAC3B,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAQlC;AAED,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/dist/render-children.js

@@ -0,0 +1,11 @@
+import { render } from "./render.js";
+async function renderChildren(initial, build, options) {
+    const { rerender } = await render(build(initial), options);
+    return {
+        rerender: async (items) => {
+            await rerender(build(items));
+        },
+    };
+}
+export { renderChildren };
+//# sourceMappingURL=render-children.js.map

package/dist/render-children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-children.js","sourceRoot":"","sources":["../src/render-children.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC,KAAK,UAAU,cAAc,CACzB,OAAY,EACZ,KAAyB,EACzB,OAAuB;IAEvB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAE3D,OAAO;QACH,QAAQ,EAAE,KAAK,EAAE,KAAU,EAAE,EAAE;YAC3B,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACjC,CAAC;KACJ,CAAC;AACN,CAAC;AAED,OAAO,EAAE,cAAc,EAAwB,CAAC","sourcesContent":["import type { ReactNode } from \"react\";\nimport type { RenderOptions } from \"./types.js\";\nimport { render } from \"./render.js\";\n\ntype ChildrenBuilder<T> = (items: T[]) => ReactNode;\n\ntype RenderChildrenResult<T> = {\n    rerender: (items: T[]) => Promise<void>;\n};\n\nasync function renderChildren<T>(\n    initial: T[],\n    build: ChildrenBuilder<T>,\n    options?: RenderOptions,\n): Promise<RenderChildrenResult<T>> {\n    const { rerender } = await render(build(initial), options);\n\n    return {\n        rerender: async (items: T[]) => {\n            await rerender(build(items));\n        },\n    };\n}\n\nexport { renderChildren, type ChildrenBuilder };\n"]}

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAkB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAqC,MAAM,YAAY,CAAC;AA+I7F;;;;;;;;GAQG;AACH,QAAA,MAAM,MAAM,GAAU,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAC3D,SAAS,SAAS,EAClB,UAAU,aAAa,CAAC,CAAC,CAAC,KAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAqDzB,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,OAAO,QAAa,OAAO,CAAC,IAAI,CAErC,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAqB,MAAM,YAAY,CAAC;AAoJ7E;;;;;;;;GAQG;AACH,QAAA,MAAM,MAAM,GAAU,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAC3D,SAAS,SAAS,EAClB,UAAU,aAAa,CAAC,CAAC,CAAC,KAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAoDzB,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,OAAO,QAAa,OAAO,CAAC,IAAI,CAErC,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC"}

package/dist/render.js

@@ -1,23 +1,25 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as Gtk from "@gtkx/gi/gtk";
-import { createReconcilerRoot, isRootElement, setReconcilerErrorHandler, } from "@gtkx/react/internal";
+import { createReconcilerRoot, isRootElement, setReconcilerErrorHandler, settleAccessible, } from "@gtkx/react/internal";
 import { StrictMode } from "react";
 import { runInAct } from "./act.js";
 import { addToCleanupQueue, runCleanup } from "./cleanup-registry.js";
 import { scheduleAfterLayout } from "./frame-sync.js";
+import { createHarnessWindow } from "./harness-window.js";
 import { logWidget } from "./pretty-widget.js";
 import { logRoles } from "./role-helpers.js";
 import { clearScreen, setScreen } from "./screen.js";
-import { captureAndSaveScreenshot } from "./screenshot.js";
-import { TOPLEVELS, traverse } from "./traversal.js";
+import { captureScreen } from "./screenshot.js";
+import { roots, TOPLEVELS } from "./traversal.js";
 import { resetClipboard } from "./user-event/index.js";
 import { within } from "./within.js";
 const reconcilerErrors = { lastError: null, isHandlerInstalled: false };
 const activeRenders = new Set();
-const HARNESS_WINDOW_WIDTH = 800;
-const HARNESS_WINDOW_HEIGHT = 600;
 const flushLayout = (window) => new Promise((resolve) => {
-    scheduleAfterLayout(window, resolve);
+    scheduleAfterLayout(window, () => {
+        settleAccessible();
+        resolve();
+    });
 });
 const update = async (element, root) => {
     await runInAct(() => {
@@ -60,7 +62,7 @@ const resolveContainer = (container) => {
     if (container instanceof Gtk.Widget) {
         return { containerInfo: container, window: null };
     }
-    const window = new Gtk.Window({ defaultWidth: HARNESS_WINDOW_WIDTH, defaultHeight: HARNESS_WINDOW_HEIGHT });
+    const window = createHarnessWindow();
     window.setDecorated(false);
     return { containerInfo: window, window };
 };
@@ -68,7 +70,7 @@ const firstToplevelWidget = (baseElement) => {
     if (baseElement instanceof Gtk.Widget) {
         return baseElement;
     }
-    const [first] = traverse(baseElement);
+    const [first] = roots(baseElement);
     if (first) {
         return first;
     }
@@ -110,7 +112,7 @@ const applyEnableAnimations = (areAnimationsEnabled) => {
  */
 const render = async (element, options) => {
     installErrorHandler();
-    applyEnableAnimations(options?.animations === true);
+    applyEnableAnimations(options?.areAnimationsEnabled === true);
     const baseElement = options?.baseElement ?? TOPLEVELS;
     const Wrapper = options?.wrapper;
     const resolved = resolveContainer(options?.container);
@@ -125,7 +127,7 @@ const render = async (element, options) => {
     addToCleanupQueue(resetClipboard);
     const wrap = (node) => {
         const wrapped = Wrapper ? _jsx(Wrapper, { children: node }) : node;
-        return options?.reactStrictMode ? _jsx(StrictMode, { children: wrapped }) : wrapped;
+        return options?.isReactStrictMode ? _jsx(StrictMode, { children: wrapped }) : wrapped;
     };
     await update(wrap(element), root);
     resolved.window?.present();
@@ -148,7 +150,7 @@ const render = async (element, options) => {
         logRoles: () => {
             logRoles(baseElement);
         },
-        screenshot: (selector, screenshotOptions) => captureAndSaveScreenshot(selector, screenshotOptions),
+        screenshot: (screenshotOptions) => captureScreen(screenshotOptions),
     };
     setScreen(result);
     return result;

package/dist/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { RootElement } from \"@gtkx/react\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    createReconcilerRoot,\n    isRootElement,\n    type ReconcilerRoot,\n    setReconcilerErrorHandler,\n} from \"@gtkx/react/internal\";\nimport { type ErrorInfo, type ReactNode, StrictMode } from \"react\";\nimport type { RenderResult } from \"./bound-queries.js\";\nimport type { QueryMap, RenderOptions, ScreenshotOptions, WindowSelector } from \"./types.js\";\nimport { runInAct } from \"./act.js\";\nimport { addToCleanupQueue, runCleanup } from \"./cleanup-registry.js\";\nimport { scheduleAfterLayout } from \"./frame-sync.js\";\nimport { logWidget, type PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport { logRoles } from \"./role-helpers.js\";\nimport { clearScreen, setScreen } from \"./screen.js\";\nimport { captureAndSaveScreenshot } from \"./screenshot.js\";\nimport { type Container, TOPLEVELS, traverse } from \"./traversal.js\";\nimport { resetClipboard } from \"./user-event/index.js\";\nimport { within } from \"./within.js\";\n\ntype ActiveRender = {\n    root: ReconcilerRoot;\n    window: Gtk.Window | null;\n};\n\ntype ResolvedContainer = {\n    containerInfo: Gtk.Widget | RootElement;\n    window: Gtk.Window | null;\n};\n\ntype ReconcilerErrorState = {\n    lastError: Error | null;\n    isHandlerInstalled: boolean;\n};\n\nconst reconcilerErrors: ReconcilerErrorState = { lastError: null, isHandlerInstalled: false };\nconst activeRenders: Set<ActiveRender> = new Set();\nconst HARNESS_WINDOW_WIDTH = 800;\nconst HARNESS_WINDOW_HEIGHT = 600;\n\nconst flushLayout = (window: Gtk.Window | null): Promise<void> =>\n    new Promise((resolve) => {\n        scheduleAfterLayout(window, resolve);\n    });\n\nconst update = async (element: ReactNode, root: ReconcilerRoot): Promise<void> => {\n    await runInAct(() => {\n        root.update(element);\n    });\n\n    if (reconcilerErrors.lastError) {\n        const captured = reconcilerErrors.lastError;\n        reconcilerErrors.lastError = null;\n        throw captured;\n    }\n};\n\nconst disposeActiveRender = async (active: ActiveRender): Promise<void> => {\n    if (!activeRenders.delete(active)) {\n        return;\n    }\n\n    await active.root.unmount(async (root) => {\n        await update(null, root);\n        active.window?.destroy();\n    });\n};\n\nconst disposeAllActiveRenders = async (): Promise<void> => {\n    for (const active of activeRenders) {\n        await disposeActiveRender(active);\n    }\n};\n\nconst handleError = (error: unknown): void => {\n    reconcilerErrors.lastError = error instanceof Error ? error : new Error(String(error));\n};\n\nconst installErrorHandler = (): void => {\n    if (reconcilerErrors.isHandlerInstalled) {\n        return;\n    }\n\n    setReconcilerErrorHandler(handleError);\n    reconcilerErrors.isHandlerInstalled = true;\n};\n\nconst resolveContainer = (container: RenderOptions[\"container\"]): ResolvedContainer => {\n    if (isRootElement(container)) {\n        return { containerInfo: container, window: null };\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return { containerInfo: container, window: null };\n    }\n\n    const window = new Gtk.Window({ defaultWidth: HARNESS_WINDOW_WIDTH, defaultHeight: HARNESS_WINDOW_HEIGHT });\n    window.setDecorated(false);\n\n    return { containerInfo: window, window };\n};\n\nconst firstToplevelWidget = (baseElement: Container): Gtk.Widget => {\n    if (baseElement instanceof Gtk.Widget) {\n        return baseElement;\n    }\n\n    const [first] = traverse(baseElement);\n\n    if (first) {\n        return first;\n    }\n\n    throw new Error(\"render() produced no widgets: ensure the element renders visible content\");\n};\n\nconst resolveResultContainer = (\n    resolved: ResolvedContainer,\n    container: RenderOptions[\"container\"],\n    baseElement: Container,\n): Gtk.Widget => {\n    if (resolved.window) {\n        return resolved.window;\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    return firstToplevelWidget(baseElement);\n};\n\nconst renderErrorHandlers = <Q extends QueryMap>(options: RenderOptions<Q> | undefined) => ({\n    onUncaughtError: handleError,\n    onCaughtError: (error: unknown, errorInfo: ErrorInfo): void => {\n        handleError(error);\n        options?.onCaughtError?.(error, errorInfo);\n    },\n    onRecoverableError: (error: unknown, errorInfo: ErrorInfo): void => {\n        options?.onRecoverableError?.(error, errorInfo);\n    },\n});\n\nconst applyEnableAnimations = (areAnimationsEnabled: boolean): void => {\n    const settings = Gtk.Settings.getDefault();\n\n    if (settings) {\n        settings.gtkEnableAnimations = areAnimationsEnabled;\n    }\n};\n\n/**\n * Renders a React element into a GTK4 widget tree and returns queries\n * scoped to it along with controls for rerendering and unmounting. When no\n * container is supplied, a harness window is created and presented.\n *\n * @param element The React element to render.\n * @param options Optional container, wrapper, custom queries, and other render settings.\n * @returns A render result with bound queries, debug helpers, and lifecycle controls.\n */\nconst render = async <Q extends QueryMap = Record<never, never>>(\n    element: ReactNode,\n    options?: RenderOptions<Q>,\n): Promise<RenderResult<Q>> => {\n    installErrorHandler();\n    applyEnableAnimations(options?.animations === true);\n    const baseElement: Container = options?.baseElement ?? TOPLEVELS;\n    const Wrapper = options?.wrapper;\n    const resolved = resolveContainer(options?.container);\n\n    const root = createReconcilerRoot({\n        containerInfo: resolved.containerInfo,\n        ...renderErrorHandlers(options),\n    });\n\n    const active: ActiveRender = { root, window: resolved.window };\n    activeRenders.add(active);\n    addToCleanupQueue(disposeAllActiveRenders);\n    addToCleanupQueue(clearScreen);\n    addToCleanupQueue(resetClipboard);\n\n    const wrap = (node: ReactNode): ReactNode => {\n        const wrapped = Wrapper ? <Wrapper>{node}</Wrapper> : node;\n\n        return options?.reactStrictMode ? <StrictMode>{wrapped}</StrictMode> : wrapped;\n    };\n\n    await update(wrap(element), root);\n    resolved.window?.present();\n    await flushLayout(resolved.window);\n    const container = resolveResultContainer(resolved, options?.container, baseElement);\n\n    const result: RenderResult<Q> = {\n        ...within(baseElement, options?.queries),\n        container,\n        baseElement,\n        unmount: async () => {\n            await disposeActiveRender(active);\n        },\n        rerender: async (newElement: ReactNode) => {\n            await update(wrap(newElement), root);\n            await flushLayout(resolved.window);\n        },\n        debug: (element: Container | Container[] = baseElement, debugOptions?: PrettyWidgetOptions) => {\n            logWidget(element, debugOptions);\n        },\n        logRoles: () => {\n            logRoles(baseElement);\n        },\n        screenshot: (selector?: WindowSelector, screenshotOptions?: ScreenshotOptions) =>\n            captureAndSaveScreenshot(selector, screenshotOptions),\n    };\n\n    setScreen(result);\n\n    return result;\n};\n\n/**\n * Unmounts every active render and runs all registered cleanup callbacks,\n * resetting the screen and clipboard. Called automatically after each test.\n */\nconst cleanup = async (): Promise<void> => {\n    await runCleanup();\n};\n\nexport { render, cleanup };\n"]}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { RootElement } from \"@gtkx/react\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    createReconcilerRoot,\n    isRootElement,\n    type ReconcilerRoot,\n    setReconcilerErrorHandler,\n    settleAccessible,\n} from \"@gtkx/react/internal\";\nimport { type ErrorInfo, type ReactNode, StrictMode } from \"react\";\nimport type { RenderResult } from \"./bound-queries.js\";\nimport type { QueryMap, RenderOptions, ScreenshotOptions } from \"./types.js\";\nimport { runInAct } from \"./act.js\";\nimport { addToCleanupQueue, runCleanup } from \"./cleanup-registry.js\";\nimport { scheduleAfterLayout } from \"./frame-sync.js\";\nimport { createHarnessWindow } from \"./harness-window.js\";\nimport { logWidget, type PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport { logRoles } from \"./role-helpers.js\";\nimport { clearScreen, setScreen } from \"./screen.js\";\nimport { captureScreen } from \"./screenshot.js\";\nimport { type Container, roots, TOPLEVELS } from \"./traversal.js\";\nimport { resetClipboard } from \"./user-event/index.js\";\nimport { within } from \"./within.js\";\n\n/** A mounted render tracked so cleanup can unmount it. */\ntype ActiveRender = {\n    /** Root that rerenders drive and that cleanup tears the tree down through. */\n    root: ReconcilerRoot;\n    /** Harness window created for the render, null when it renders into a container the caller supplied. */\n    window: Gtk.Window | null;\n};\n\ntype ResolvedContainer = {\n    containerInfo: Gtk.Widget | RootElement;\n    window: Gtk.Window | null;\n};\n\ntype ReconcilerErrorState = {\n    lastError: Error | null;\n    isHandlerInstalled: boolean;\n};\n\nconst reconcilerErrors: ReconcilerErrorState = { lastError: null, isHandlerInstalled: false };\nconst activeRenders: Set<ActiveRender> = new Set();\n\nconst flushLayout = (window: Gtk.Window | null): Promise<void> =>\n    new Promise<void>((resolve) => {\n        scheduleAfterLayout(window, () => {\n            settleAccessible();\n            resolve();\n        });\n    });\n\nconst update = async (element: ReactNode, root: ReconcilerRoot): Promise<void> => {\n    await runInAct(() => {\n        root.update(element);\n    });\n\n    if (reconcilerErrors.lastError) {\n        const captured = reconcilerErrors.lastError;\n        reconcilerErrors.lastError = null;\n        throw captured;\n    }\n};\n\nconst disposeActiveRender = async (active: ActiveRender): Promise<void> => {\n    if (!activeRenders.delete(active)) {\n        return;\n    }\n\n    await active.root.unmount(async (root) => {\n        await update(null, root);\n        active.window?.destroy();\n    });\n};\n\nconst disposeAllActiveRenders = async (): Promise<void> => {\n    for (const active of activeRenders) {\n        await disposeActiveRender(active);\n    }\n};\n\nconst handleError = (error: unknown): void => {\n    reconcilerErrors.lastError = error instanceof Error ? error : new Error(String(error));\n};\n\nconst installErrorHandler = (): void => {\n    if (reconcilerErrors.isHandlerInstalled) {\n        return;\n    }\n\n    setReconcilerErrorHandler(handleError);\n    reconcilerErrors.isHandlerInstalled = true;\n};\n\nconst resolveContainer = (container: RenderOptions[\"container\"]): ResolvedContainer => {\n    if (isRootElement(container)) {\n        return { containerInfo: container, window: null };\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return { containerInfo: container, window: null };\n    }\n\n    const window = createHarnessWindow();\n    window.setDecorated(false);\n\n    return { containerInfo: window, window };\n};\n\nconst firstToplevelWidget = (baseElement: Container): Gtk.Widget => {\n    if (baseElement instanceof Gtk.Widget) {\n        return baseElement;\n    }\n\n    const [first] = roots(baseElement);\n\n    if (first) {\n        return first;\n    }\n\n    throw new Error(\"render() produced no widgets: ensure the element renders visible content\");\n};\n\nconst resolveResultContainer = (\n    resolved: ResolvedContainer,\n    container: RenderOptions[\"container\"],\n    baseElement: Container,\n): Gtk.Widget => {\n    if (resolved.window) {\n        return resolved.window;\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    return firstToplevelWidget(baseElement);\n};\n\nconst renderErrorHandlers = <Q extends QueryMap>(options: RenderOptions<Q> | undefined) => ({\n    onUncaughtError: handleError,\n    onCaughtError: (error: unknown, errorInfo: ErrorInfo): void => {\n        handleError(error);\n        options?.onCaughtError?.(error, errorInfo);\n    },\n    onRecoverableError: (error: unknown, errorInfo: ErrorInfo): void => {\n        options?.onRecoverableError?.(error, errorInfo);\n    },\n});\n\nconst applyEnableAnimations = (areAnimationsEnabled: boolean): void => {\n    const settings = Gtk.Settings.getDefault();\n\n    if (settings) {\n        settings.gtkEnableAnimations = areAnimationsEnabled;\n    }\n};\n\n/**\n * Renders a React element into a GTK4 widget tree and returns queries\n * scoped to it along with controls for rerendering and unmounting. When no\n * container is supplied, a harness window is created and presented.\n *\n * @param element The React element to render.\n * @param options Optional container, wrapper, custom queries, and other render settings.\n * @returns A render result with bound queries, debug helpers, and lifecycle controls.\n */\nconst render = async <Q extends QueryMap = Record<never, never>>(\n    element: ReactNode,\n    options?: RenderOptions<Q>,\n): Promise<RenderResult<Q>> => {\n    installErrorHandler();\n    applyEnableAnimations(options?.areAnimationsEnabled === true);\n    const baseElement: Container = options?.baseElement ?? TOPLEVELS;\n    const Wrapper = options?.wrapper;\n    const resolved = resolveContainer(options?.container);\n\n    const root = createReconcilerRoot({\n        containerInfo: resolved.containerInfo,\n        ...renderErrorHandlers(options),\n    });\n\n    const active: ActiveRender = { root, window: resolved.window };\n    activeRenders.add(active);\n    addToCleanupQueue(disposeAllActiveRenders);\n    addToCleanupQueue(clearScreen);\n    addToCleanupQueue(resetClipboard);\n\n    const wrap = (node: ReactNode): ReactNode => {\n        const wrapped = Wrapper ? <Wrapper>{node}</Wrapper> : node;\n\n        return options?.isReactStrictMode ? <StrictMode>{wrapped}</StrictMode> : wrapped;\n    };\n\n    await update(wrap(element), root);\n    resolved.window?.present();\n    await flushLayout(resolved.window);\n    const container = resolveResultContainer(resolved, options?.container, baseElement);\n\n    const result: RenderResult<Q> = {\n        ...within(baseElement, options?.queries),\n        container,\n        baseElement,\n        unmount: async () => {\n            await disposeActiveRender(active);\n        },\n        rerender: async (newElement: ReactNode) => {\n            await update(wrap(newElement), root);\n            await flushLayout(resolved.window);\n        },\n        debug: (element: Container | Container[] = baseElement, debugOptions?: PrettyWidgetOptions) => {\n            logWidget(element, debugOptions);\n        },\n        logRoles: () => {\n            logRoles(baseElement);\n        },\n        screenshot: (screenshotOptions?: ScreenshotOptions) => captureScreen(screenshotOptions),\n    };\n\n    setScreen(result);\n\n    return result;\n};\n\n/**\n * Unmounts every active render and runs all registered cleanup callbacks,\n * resetting the screen and clipboard. Called automatically after each test.\n */\nconst cleanup = async (): Promise<void> => {\n    await runCleanup();\n};\n\nexport { render, cleanup };\n"]}

package/dist/role-helpers.d.ts

@@ -9,15 +9,17 @@ import { type Container } from "./traversal.js";
 declare const formatRole: (role: Gtk.AccessibleRole) => string;
 declare const formatRoleList: (roles: Iterable<Gtk.AccessibleRole>) => string;
 /**
- * Groups every widget in a container's tree by its accessible role name.
+ * Groups every mapped widget in a container's tree by its accessible role name. Widgets that are not
+ * mapped are left out.
  *
  * @param container The scope to traverse.
- * @returns A map from role name to the widgets that have that role.
+ * @returns A map from role name to the mapped widgets that have that role.
  */
 declare const getRoles: (container: Container) => Map<string, Gtk.Widget[]>;
 /**
  * Formats the accessible roles in a container's tree as a readable string,
  * listing each role together with its widgets and their accessible names.
+ * Widgets that are not mapped are left out.
  *
  * @param container The scope to inspect.
  */
@@ -29,5 +31,12 @@ declare const prettyRoles: (container: Container) => string;
  * @param container The scope to inspect.
  */
 declare const logRoles: (container: Container) => void;
-export { formatRole, formatRoleList, getRoles, prettyRoles, logRoles };
+/**
+ * Returns the heading or hierarchy level GTK reports for a widget, or undefined when it declares
+ * none.
+ *
+ * @param widget The widget to read the level from.
+ */
+declare const computeHeadingLevel: (widget: Gtk.Widget) => number | undefined;
+export { computeHeadingLevel, formatRole, formatRoleList, getRoles, prettyRoles, logRoles };
 //# sourceMappingURL=role-helpers.d.ts.map

package/dist/role-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"role-helpers.d.ts","sourceRoot":"","sources":["../src/role-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,gBAAgB,CAAC;AAa1D;;;;;GAKG;AACH,QAAA,MAAM,UAAU,GAAI,MAAM,GAAG,CAAC,cAAc,KAAG,MAQ9C,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,OAAO,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,KAAG,MAe7D,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,QAAQ,GAAI,WAAW,SAAS,KAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAehE,CAAC;AAUF;;;;;GAKG;AACH,QAAA,MAAM,WAAW,GAAI,WAAW,SAAS,KAAG,MAqB3C,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,QAAQ,GAAI,WAAW,SAAS,KAAG,IAExC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"role-helpers.d.ts","sourceRoot":"","sources":["../src/role-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,gBAAgB,CAAC;AAa1D;;;;;GAKG;AACH,QAAA,MAAM,UAAU,GAAI,MAAM,GAAG,CAAC,cAAc,KAAG,MAQ9C,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,OAAO,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,KAAG,MAe7D,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,QAAQ,GAAI,WAAW,SAAS,KAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAehE,CAAC;AAUF;;;;;;GAMG;AACH,QAAA,MAAM,WAAW,GAAI,WAAW,SAAS,KAAG,MAqB3C,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,QAAQ,GAAI,WAAW,SAAS,KAAG,IAExC,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,mBAAmB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,SAAgD,CAAC;AAE5G,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/role-helpers.js

@@ -1,7 +1,7 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { sortStringsBy } from "@gtkx/utils";
 import { traverse } from "./traversal.js";
-import { getWidgetAccessibleName } from "./widget-accessible-properties.js";
+import { getWidgetAccessibleName, getWidgetLevel } from "./widget-accessible-properties.js";
 const ROLE_NAMES_BY_VALUE = enumNamesByValue(Gtk.AccessibleRole);
 function enumNamesByValue(enumObject) {
     return new Map(Object.entries(enumObject)
@@ -34,10 +34,11 @@ const formatRoleList = (roles) => {
     return `${head.join(", ")}, or ${last}`;
 };
 /**
- * Groups every widget in a container's tree by its accessible role name.
+ * Groups every mapped widget in a container's tree by its accessible role name. Widgets that are not
+ * mapped are left out.
  *
  * @param container The scope to traverse.
- * @returns A map from role name to the widgets that have that role.
+ * @returns A map from role name to the mapped widgets that have that role.
  */
 const getRoles = (container) => {
     const roles = new Map();
@@ -62,6 +63,7 @@ const formatWidgetPreview = (widget, name) => {
 /**
  * Formats the accessible roles in a container's tree as a readable string,
  * listing each role together with its widgets and their accessible names.
+ * Widgets that are not mapped are left out.
  *
  * @param container The scope to inspect.
  */
@@ -90,5 +92,12 @@ const prettyRoles = (container) => {
 const logRoles = (container) => {
     console.log(prettyRoles(container));
 };
-export { formatRole, formatRoleList, getRoles, prettyRoles, logRoles };
+/**
+ * Returns the heading or hierarchy level GTK reports for a widget, or undefined when it declares
+ * none.
+ *
+ * @param widget The widget to read the level from.
+ */
+const computeHeadingLevel = (widget) => getWidgetLevel(widget) ?? undefined;
+export { computeHeadingLevel, formatRole, formatRoleList, getRoles, prettyRoles, logRoles };
 //# sourceMappingURL=role-helpers.js.map

package/dist/role-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"role-helpers.js","sourceRoot":"","sources":["../src/role-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { sortStringsBy } from \"@gtkx/utils\";\nimport { type Container, traverse } from \"./traversal.js\";\nimport { getWidgetAccessibleName } from \"./widget-accessible-properties.js\";\n\nconst ROLE_NAMES_BY_VALUE = enumNamesByValue(Gtk.AccessibleRole);\n\nfunction enumNamesByValue(enumObject: Record<string, string | number>): Map<number, string> {\n    return new Map<number, string>(\n        Object.entries(enumObject)\n            .filter((entry): entry is [string, number] => typeof entry[1] === \"number\")\n            .map(([name, value]) => [value, name]),\n    );\n}\n\n/**\n * Converts an accessible role enum value into its lowercase name, falling back\n * to the numeric value when the role is unknown.\n *\n * @param role The accessible role to format.\n */\nconst formatRole = (role: Gtk.AccessibleRole): string => {\n    const name = ROLE_NAMES_BY_VALUE.get(role);\n\n    if (!name) {\n        return String(role);\n    }\n\n    return name.toLowerCase();\n};\n\nconst formatRoleList = (roles: Iterable<Gtk.AccessibleRole>): string => {\n    const names = [...roles].map((role) => formatRole(role).toUpperCase());\n\n    if (names.length <= 1) {\n        return names.join(\"\");\n    }\n\n    if (names.length === 2) {\n        return names.join(\" or \");\n    }\n\n    const head = names.slice(0, -1);\n    const last = names.at(-1) ?? \"\";\n\n    return `${head.join(\", \")}, or ${last}`;\n};\n\n/**\n * Groups every widget in a container's tree by its accessible role name.\n *\n * @param container The scope to traverse.\n * @returns A map from role name to the widgets that have that role.\n */\nconst getRoles = (container: Container): Map<string, Gtk.Widget[]> => {\n    const roles: Map<string, Gtk.Widget[]> = new Map();\n\n    for (const widget of traverse(container)) {\n        const roleName = formatRole(widget.getAccessibleRole());\n        const existing = roles.get(roleName);\n\n        if (existing) {\n            existing.push(widget);\n        } else {\n            roles.set(roleName, [widget]);\n        }\n    }\n\n    return roles;\n};\n\nconst formatWidgetPreview = (widget: Gtk.Widget, name: string | null): string => {\n    const tagName = widget.constructor.name;\n    const roleAttr = formatRole(widget.getAccessibleRole());\n    const nameDisplay = name ? `Name \"${name}\"` : 'Name \"\"';\n\n    return `${nameDisplay}: <${tagName} role=\"${roleAttr}\">${name ?? \"\"}</${tagName}>`;\n};\n\n/**\n * Formats the accessible roles in a container's tree as a readable string,\n * listing each role together with its widgets and their accessible names.\n *\n * @param container The scope to inspect.\n */\nconst prettyRoles = (container: Container): string => {\n    const roles = getRoles(container);\n\n    if (roles.size === 0) {\n        return \"No accessible roles found in the widget tree.\";\n    }\n\n    const lines: string[] = [];\n    const sortedRoles = sortStringsBy([...roles], ([roleName]) => roleName);\n\n    for (const [roleName, widgets] of sortedRoles) {\n        lines.push(`${roleName}:`);\n\n        for (const widget of widgets) {\n            lines.push(`  ${formatWidgetPreview(widget, getWidgetAccessibleName(widget))}`);\n        }\n\n        lines.push(\"\");\n    }\n\n    return lines.join(\"\\n\").trimEnd();\n};\n\n/**\n * Prints the accessible roles in a container's tree to the console using\n * {@link prettyRoles}.\n *\n * @param container The scope to inspect.\n */\nconst logRoles = (container: Container): void => {\n    console.log(prettyRoles(container));\n};\n\nexport { formatRole, formatRoleList, getRoles, prettyRoles, logRoles };\n"]}
+{"version":3,"file":"role-helpers.js","sourceRoot":"","sources":["../src/role-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAkB,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAE5F,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAEjE,SAAS,gBAAgB,CAAC,UAA2C;IACjE,OAAO,IAAI,GAAG,CACV,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;SAC1E,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAC7C,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,IAAwB,EAAU,EAAE;IACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAmC,EAAU,EAAE;IACnE,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAEvE,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,CAAC,SAAoB,EAA6B,EAAE;IACjE,MAAM,KAAK,GAA8B,IAAI,GAAG,EAAE,CAAC;IAEnD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAErC,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,MAAkB,EAAE,IAAmB,EAAU,EAAE;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAExD,OAAO,GAAG,WAAW,MAAM,OAAO,UAAU,QAAQ,KAAK,IAAI,IAAI,EAAE,KAAK,OAAO,GAAG,CAAC;AACvF,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,SAAoB,EAAU,EAAE;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,+CAA+C,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IAExE,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;QAE3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACtC,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,QAAQ,GAAG,CAAC,SAAoB,EAAQ,EAAE;IAC5C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,CAAC,MAAkB,EAAsB,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;AAE5G,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { sortStringsBy } from \"@gtkx/utils\";\nimport { type Container, traverse } from \"./traversal.js\";\nimport { getWidgetAccessibleName, getWidgetLevel } from \"./widget-accessible-properties.js\";\n\nconst ROLE_NAMES_BY_VALUE = enumNamesByValue(Gtk.AccessibleRole);\n\nfunction enumNamesByValue(enumObject: Record<string, string | number>): Map<number, string> {\n    return new Map<number, string>(\n        Object.entries(enumObject)\n            .filter((entry): entry is [string, number] => typeof entry[1] === \"number\")\n            .map(([name, value]) => [value, name]),\n    );\n}\n\n/**\n * Converts an accessible role enum value into its lowercase name, falling back\n * to the numeric value when the role is unknown.\n *\n * @param role The accessible role to format.\n */\nconst formatRole = (role: Gtk.AccessibleRole): string => {\n    const name = ROLE_NAMES_BY_VALUE.get(role);\n\n    if (!name) {\n        return String(role);\n    }\n\n    return name.toLowerCase();\n};\n\nconst formatRoleList = (roles: Iterable<Gtk.AccessibleRole>): string => {\n    const names = [...roles].map((role) => formatRole(role).toUpperCase());\n\n    if (names.length <= 1) {\n        return names.join(\"\");\n    }\n\n    if (names.length === 2) {\n        return names.join(\" or \");\n    }\n\n    const head = names.slice(0, -1);\n    const last = names.at(-1) ?? \"\";\n\n    return `${head.join(\", \")}, or ${last}`;\n};\n\n/**\n * Groups every mapped widget in a container's tree by its accessible role name. Widgets that are not\n * mapped are left out.\n *\n * @param container The scope to traverse.\n * @returns A map from role name to the mapped widgets that have that role.\n */\nconst getRoles = (container: Container): Map<string, Gtk.Widget[]> => {\n    const roles: Map<string, Gtk.Widget[]> = new Map();\n\n    for (const widget of traverse(container)) {\n        const roleName = formatRole(widget.getAccessibleRole());\n        const existing = roles.get(roleName);\n\n        if (existing) {\n            existing.push(widget);\n        } else {\n            roles.set(roleName, [widget]);\n        }\n    }\n\n    return roles;\n};\n\nconst formatWidgetPreview = (widget: Gtk.Widget, name: string | null): string => {\n    const tagName = widget.constructor.name;\n    const roleAttr = formatRole(widget.getAccessibleRole());\n    const nameDisplay = name ? `Name \"${name}\"` : 'Name \"\"';\n\n    return `${nameDisplay}: <${tagName} role=\"${roleAttr}\">${name ?? \"\"}</${tagName}>`;\n};\n\n/**\n * Formats the accessible roles in a container's tree as a readable string,\n * listing each role together with its widgets and their accessible names.\n * Widgets that are not mapped are left out.\n *\n * @param container The scope to inspect.\n */\nconst prettyRoles = (container: Container): string => {\n    const roles = getRoles(container);\n\n    if (roles.size === 0) {\n        return \"No accessible roles found in the widget tree.\";\n    }\n\n    const lines: string[] = [];\n    const sortedRoles = sortStringsBy([...roles], ([roleName]) => roleName);\n\n    for (const [roleName, widgets] of sortedRoles) {\n        lines.push(`${roleName}:`);\n\n        for (const widget of widgets) {\n            lines.push(`  ${formatWidgetPreview(widget, getWidgetAccessibleName(widget))}`);\n        }\n\n        lines.push(\"\");\n    }\n\n    return lines.join(\"\\n\").trimEnd();\n};\n\n/**\n * Prints the accessible roles in a container's tree to the console using\n * {@link prettyRoles}.\n *\n * @param container The scope to inspect.\n */\nconst logRoles = (container: Container): void => {\n    console.log(prettyRoles(container));\n};\n\n/**\n * Returns the heading or hierarchy level GTK reports for a widget, or undefined when it declares\n * none.\n *\n * @param widget The widget to read the level from.\n */\nconst computeHeadingLevel = (widget: Gtk.Widget): number | undefined => getWidgetLevel(widget) ?? undefined;\n\nexport { computeHeadingLevel, formatRole, formatRoleList, getRoles, prettyRoles, logRoles };\n"]}

package/dist/role-naming.d.ts

@@ -0,0 +1,5 @@
+import * as Gtk from "@gtkx/gi/gtk";
+declare const isNameProhibited: (role: Gtk.AccessibleRole) => boolean;
+declare const isNameFromAuthor: (role: Gtk.AccessibleRole) => boolean;
+export { isNameFromAuthor, isNameProhibited };
+//# sourceMappingURL=role-naming.d.ts.map

package/dist/role-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-naming.d.ts","sourceRoot":"","sources":["../src/role-naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AA+FpC,QAAA,MAAM,gBAAgB,GAAI,MAAM,GAAG,CAAC,cAAc,KAAG,OAA+C,CAAC;AACrG,QAAA,MAAM,gBAAgB,GAAI,MAAM,GAAG,CAAC,cAAc,KAAG,OAAgD,CAAC;AAEtG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/role-naming.js

@@ -0,0 +1,96 @@
+import * as Gtk from "@gtkx/gi/gtk";
+const FROM_AUTHOR = 1;
+const FROM_CONTENT = 2;
+const PROHIBITED = 4;
+const NAMING = {
+    [Gtk.AccessibleRole.ALERT]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.ALERT_DIALOG]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.APPLICATION]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.ARTICLE]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.BANNER]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.BLOCK_QUOTE]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.BUTTON]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.CAPTION]: PROHIBITED,
+    [Gtk.AccessibleRole.CELL]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.CHECKBOX]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.COLUMN_HEADER]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.COMBO_BOX]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.COMMAND]: PROHIBITED,
+    [Gtk.AccessibleRole.COMMENT]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.COMPOSITE]: PROHIBITED,
+    [Gtk.AccessibleRole.DIALOG]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.DOCUMENT]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.FEED]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.FORM]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.GENERIC]: PROHIBITED,
+    [Gtk.AccessibleRole.GRID]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.GRID_CELL]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.GROUP]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.HEADING]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.IMG]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.INPUT]: PROHIBITED,
+    [Gtk.AccessibleRole.LABEL]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.LANDMARK]: PROHIBITED,
+    [Gtk.AccessibleRole.LEGEND]: PROHIBITED,
+    [Gtk.AccessibleRole.LINK]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.LIST]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.LIST_BOX]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.LIST_ITEM]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.LOG]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.MAIN]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.MARQUEE]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.MATH]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.METER]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.MENU]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.MENU_BAR]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.MENU_ITEM]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.MENU_ITEM_CHECKBOX]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.MENU_ITEM_RADIO]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.NAVIGATION]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.NONE]: PROHIBITED,
+    [Gtk.AccessibleRole.NOTE]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.OPTION]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.PARAGRAPH]: PROHIBITED,
+    [Gtk.AccessibleRole.PRESENTATION]: PROHIBITED,
+    [Gtk.AccessibleRole.PROGRESS_BAR]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.RADIO]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.RADIO_GROUP]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.RANGE]: PROHIBITED,
+    [Gtk.AccessibleRole.REGION]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.ROW]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.ROW_GROUP]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.ROW_HEADER]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.SCROLLBAR]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.SEARCH]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.SEARCH_BOX]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.SECTION]: PROHIBITED,
+    [Gtk.AccessibleRole.SECTION_HEAD]: PROHIBITED,
+    [Gtk.AccessibleRole.SELECT]: PROHIBITED,
+    [Gtk.AccessibleRole.SEPARATOR]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.SLIDER]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.SPIN_BUTTON]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.STATUS]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.STRUCTURE]: PROHIBITED,
+    [Gtk.AccessibleRole.SWITCH]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.TAB]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.TABLE]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TAB_LIST]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TAB_PANEL]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TERMINAL]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TEXT_BOX]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TIME]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TIMER]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TOGGLE_BUTTON]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TOOLBAR]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TOOLTIP]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.TREE]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TREE_GRID]: FROM_AUTHOR,
+    [Gtk.AccessibleRole.TREE_ITEM]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.WIDGET]: FROM_AUTHOR | FROM_CONTENT,
+    [Gtk.AccessibleRole.WINDOW]: FROM_AUTHOR,
+};
+const namingFor = (role) => NAMING[role] ?? 0;
+const isNameProhibited = (role) => (namingFor(role) & PROHIBITED) !== 0;
+const isNameFromAuthor = (role) => (namingFor(role) & FROM_AUTHOR) !== 0;
+export { isNameFromAuthor, isNameProhibited };
+//# sourceMappingURL=role-naming.js.map

package/dist/role-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-naming.js","sourceRoot":"","sources":["../src/role-naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,MAAM,MAAM,GAAgD;IACxD,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,WAAW;IAC9C,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW;IAC7C,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW;IACzC,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW;IAC7C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY;IACvD,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,UAAU;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY;IACrD,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,YAAY;IACzD,CAAC,GAAG,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,WAAW,GAAG,YAAY;IAC9D,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,UAAU;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY;IACxD,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,UAAU;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,UAAU;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,YAAY;IAC1D,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY;IACxD,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW;IACrC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IACtD,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU;IACzC,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY;IACrD,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW;IACrC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW;IACzC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,YAAY;IAC1D,CAAC,GAAG,CAAC,cAAc,CAAC,kBAAkB,CAAC,EAAE,WAAW,GAAG,YAAY;IACnE,CAAC,GAAG,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG,YAAY;IAChE,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,WAAW;IAC5C,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,UAAU;IACrC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY;IACvD,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,UAAU;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,UAAU;IAC7C,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,WAAW;IAC9C,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IACtD,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW;IAC7C,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,YAAY;IACpD,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,YAAY;IAC3D,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,WAAW;IAC5C,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,UAAU;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,UAAU;IAC7C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,WAAW;IAC7C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;IACxC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,UAAU;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY;IACvD,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,YAAY;IACpD,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;IAC1C,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,WAAW;IACvC,CAAC,GAAG,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,WAAW;IAC/C,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW;IACzC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY;IACxD,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW;IACtC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW;IAC3C,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,YAAY;IAC1D,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY;IACvD,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW;CAC3C,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAwB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1E,MAAM,gBAAgB,GAAG,CAAC,IAAwB,EAAW,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AACrG,MAAM,gBAAgB,GAAG,CAAC,IAAwB,EAAW,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;AAEtG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\n\nconst FROM_AUTHOR = 1;\nconst FROM_CONTENT = 2;\nconst PROHIBITED = 4;\n\nconst NAMING: Partial<Record<Gtk.AccessibleRole, number>> = {\n    [Gtk.AccessibleRole.ALERT]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.ALERT_DIALOG]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.APPLICATION]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.ARTICLE]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.BANNER]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.BLOCK_QUOTE]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.BUTTON]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.CAPTION]: PROHIBITED,\n    [Gtk.AccessibleRole.CELL]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.CHECKBOX]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.COLUMN_HEADER]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.COMBO_BOX]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.COMMAND]: PROHIBITED,\n    [Gtk.AccessibleRole.COMMENT]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.COMPOSITE]: PROHIBITED,\n    [Gtk.AccessibleRole.DIALOG]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.DOCUMENT]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.FEED]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.FORM]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.GENERIC]: PROHIBITED,\n    [Gtk.AccessibleRole.GRID]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.GRID_CELL]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.GROUP]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.HEADING]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.IMG]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.INPUT]: PROHIBITED,\n    [Gtk.AccessibleRole.LABEL]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.LANDMARK]: PROHIBITED,\n    [Gtk.AccessibleRole.LEGEND]: PROHIBITED,\n    [Gtk.AccessibleRole.LINK]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.LIST]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.LIST_BOX]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.LIST_ITEM]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.LOG]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.MAIN]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.MARQUEE]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.MATH]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.METER]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.MENU]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.MENU_BAR]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.MENU_ITEM]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.MENU_ITEM_CHECKBOX]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.MENU_ITEM_RADIO]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.NAVIGATION]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.NONE]: PROHIBITED,\n    [Gtk.AccessibleRole.NOTE]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.OPTION]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.PARAGRAPH]: PROHIBITED,\n    [Gtk.AccessibleRole.PRESENTATION]: PROHIBITED,\n    [Gtk.AccessibleRole.PROGRESS_BAR]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.RADIO]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.RADIO_GROUP]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.RANGE]: PROHIBITED,\n    [Gtk.AccessibleRole.REGION]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.ROW]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.ROW_GROUP]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.ROW_HEADER]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.SCROLLBAR]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.SEARCH]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.SEARCH_BOX]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.SECTION]: PROHIBITED,\n    [Gtk.AccessibleRole.SECTION_HEAD]: PROHIBITED,\n    [Gtk.AccessibleRole.SELECT]: PROHIBITED,\n    [Gtk.AccessibleRole.SEPARATOR]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.SLIDER]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.SPIN_BUTTON]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.STATUS]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.STRUCTURE]: PROHIBITED,\n    [Gtk.AccessibleRole.SWITCH]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.TAB]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.TABLE]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TAB_LIST]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TAB_PANEL]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TERMINAL]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TEXT_BOX]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TIME]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TIMER]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TOGGLE_BUTTON]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TOOLBAR]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TOOLTIP]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.TREE]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TREE_GRID]: FROM_AUTHOR,\n    [Gtk.AccessibleRole.TREE_ITEM]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.WIDGET]: FROM_AUTHOR | FROM_CONTENT,\n    [Gtk.AccessibleRole.WINDOW]: FROM_AUTHOR,\n};\n\nconst namingFor = (role: Gtk.AccessibleRole): number => NAMING[role] ?? 0;\nconst isNameProhibited = (role: Gtk.AccessibleRole): boolean => (namingFor(role) & PROHIBITED) !== 0;\nconst isNameFromAuthor = (role: Gtk.AccessibleRole): boolean => (namingFor(role) & FROM_AUTHOR) !== 0;\n\nexport { isNameFromAuthor, isNameProhibited };\n"]}

package/dist/screenshot.d.ts

@@ -1,28 +1,20 @@
 import * as Gtk from "@gtkx/gi/gtk";
-import type { ScreenshotOptions, ScreenshotResult, WindowSelector } from "./types.js";
+import type { ScreenshotOptions, ScreenshotResult } from "./types.js";
 /**
- * Captures a PNG snapshot of a widget, retrying until it has a paintable size.
+ * Captures a PNG snapshot of a widget, retrying until it has a paintable size,
+ * and writes the image to `options.path` when one is given, creating any
+ * missing parent directories. Popovers open inside the widget render on their
+ * own surfaces, so they are composited into the image at their on-screen
+ * positions. A display that never presents a frame leaves GTK without a cached
+ * render node, so the widget's contents are then snapshotted directly; when
+ * even that yields nothing, the failure names the display instead of blaming
+ * the widget.
  *
  * @param widget The widget to render to an image.
- * @param options Optional scale, timeout, and retry interval.
+ * @param options Optional scale, timeout, retry interval, and output path.
  * @returns The base64-encoded PNG data along with its mime type and dimensions.
  */
 declare const screenshot: (widget: Gtk.Widget, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
-/**
- * Prints a clickable file URL for a saved screenshot to the console.
- *
- * @param filepath Absolute path of the saved screenshot file.
- */
-declare const logScreenshotPath: (filepath: string) => void;
-/**
- * Captures a screenshot of a toplevel window, writes it to a temporary file,
- * logs its path, and returns the image data.
- *
- * @param selector Chooses the window by index, title substring, or regular
- * expression; defaults to the first toplevel.
- * @param options Optional scale, timeout, and retry interval.
- * @returns The base64-encoded PNG data along with its mime type and dimensions.
- */
-declare const captureAndSaveScreenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
-export { screenshot, logScreenshotPath, captureAndSaveScreenshot };
+declare const captureScreen: (options?: ScreenshotOptions) => Promise<ScreenshotResult>;
+export { captureScreen, screenshot };
 //# sourceMappingURL=screenshot.d.ts.map

package/dist/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAIpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuDtF;;;;;;GAMG;AACH,QAAA,MAAM,UAAU,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAWnG,CAAC;AAqEF;;;;GAIG;AACH,QAAA,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,IAE7C,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,wBAAwB,GAC1B,WAAW,cAAc,EACzB,UAAU,iBAAiB,KAC5B,OAAO,CAAC,gBAAgB,CAM1B,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2RtE;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,UAAU,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAkBnG,CAAC;AAkBF,QAAA,MAAM,aAAa,GAAU,UAAU,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAIlF,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}