@gtkx/testing 0.21.0 → 1.0.0-rc.1

package/dist/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RootElement } from \"@gtkx/react\";\nimport {\n    createReconcilerRoot,\n    isRootElement,\n    type ReconcilerRoot,\n    setReconcilerErrorHandler,\n} from \"@gtkx/react/internal\";\nimport { type ErrorInfo, type ReactNode, StrictMode } from \"react\";\nimport { runInAct } from \"./act.js\";\nimport type { RenderResult } from \"./bound-queries.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 type { QueryMap, RenderOptions, ScreenshotOptions, WindowSelector } from \"./types.js\";\nimport { resetClipboard } from \"./user-event/index.js\";\nimport { within } from \"./within.js\";\n\nlet lastRenderError: Error | null = null;\nlet errorHandlerInstalled = false;\n\ntype ActiveRender = {\n    root: ReconcilerRoot;\n    window: Gtk.Window | null;\n};\n\nconst activeRenders = new Set<ActiveRender>();\n\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 (lastRenderError) {\n        const captured = lastRenderError;\n        lastRenderError = null;\n        throw captured;\n    }\n};\n\nconst disposeActiveRender = async (active: ActiveRender): Promise<void> => {\n    if (!activeRenders.delete(active)) return;\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    lastRenderError = error instanceof Error ? error : new Error(String(error));\n};\n\nconst installErrorHandler = (): void => {\n    if (errorHandlerInstalled) return;\n    setReconcilerErrorHandler(handleError);\n    errorHandlerInstalled = true;\n};\n\ntype ResolvedContainer = {\n    containerInfo: Gtk.Widget | RootElement;\n    window: Gtk.Window | null;\n};\n\nconst resolveContainer = (container: RenderOptions[\"container\"]): ResolvedContainer => {\n    if (isRootElement(container)) {\n        return { containerInfo: container, window: null };\n    }\n    if (container instanceof Gtk.Widget) {\n        return { containerInfo: container, window: null };\n    }\n    const window = new Gtk.Window({ defaultWidth: HARNESS_WINDOW_WIDTH, defaultHeight: HARNESS_WINDOW_HEIGHT });\n    window.setTitlebar(new Gtk.HeaderBar({ showTitleButtons: false }));\n    return { containerInfo: window, window };\n};\n\nconst firstToplevelWidget = (baseElement: Container): Gtk.Widget => {\n    if (baseElement instanceof Gtk.Widget) return baseElement;\n    const [first] = traverse(baseElement);\n    if (first) return first;\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) return resolved.window;\n    if (container instanceof Gtk.Widget) return container;\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 = (enabled: boolean): void => {\n    const settings = Gtk.Settings.getDefault();\n    if (settings) {\n        settings.gtkEnableAnimations = enabled;\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 */\nexport const render = async <Q extends QueryMap = Record<never, never>>(\n    element: ReactNode,\n    options?: RenderOptions<Q>,\n): Promise<RenderResult<Q>> => {\n    installErrorHandler();\n\n    applyEnableAnimations(options?.animations === true);\n\n    const baseElement: Container = options?.baseElement ?? TOPLEVELS;\n    const Wrapper = options?.wrapper;\n\n    const resolved = resolveContainer(options?.container);\n    const root = createReconcilerRoot({\n        containerInfo: resolved.containerInfo,\n        ...renderErrorHandlers(options),\n    });\n    const active: ActiveRender = { root, window: resolved.window };\n    activeRenders.add(active);\n\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        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\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 */\nexport const cleanup = async (): Promise<void> => {\n    await runCleanup();\n};\n"]}

package/dist/role-helpers.d.ts

@@ -1,67 +1,32 @@
-import * as Gtk from "@gtkx/ffi/gtk";
+import * as Gtk from "@gtkx/gi/gtk";
 import { type Container } from "./traversal.js";
 /**
- * Information about a widget and its accessible name.
- */
-export type RoleInfo = {
-    widget: Gtk.Widget;
-    name: string | null;
-};
-/**
- * Formats a GTK accessible role to a lowercase string.
+ * Converts an accessible role enum value into its lowercase name, falling back
+ * to the numeric value when the role is unknown.
  *
- * @param role - The GTK accessible role
- * @returns Lowercase role name (e.g., "button", "checkbox")
+ * @param role The accessible role to format.
  */
-export declare const formatRole: (role: Gtk.AccessibleRole | undefined) => string;
+export declare const formatRole: (role: Gtk.AccessibleRole) => string;
+export declare const formatRoleList: (roles: Iterable<Gtk.AccessibleRole>) => string;
 /**
- * Collects all accessible roles and their widgets from a container.
- *
- * Returns a Map where keys are role names (lowercase) and values are
- * arrays of widgets with that role, including their accessible names.
- *
- * @param container - The container to scan for roles
- * @returns Map of role names to arrays of RoleInfo
+ * Groups every widget in a container's tree by its accessible role name.
  *
- * @example
- * ```tsx
- * import { getRoles } from "@gtkx/testing";
- *
- * const roles = getRoles(container);
- * // Map {
- * //   "button" => [{ widget: ..., name: "Submit" }, { widget: ..., name: "Cancel" }],
- * //   "checkbox" => [{ widget: ..., name: "Remember me" }]
- * // }
- * ```
+ * @param container The scope to traverse.
+ * @returns A map from role name to the widgets that have that role.
  */
-export declare const getRoles: (container: Container) => Map<string, RoleInfo[]>;
+export declare const getRoles: (container: Container) => Map<string, Gtk.Widget[]>;
 /**
- * Formats roles into a readable string for error messages.
+ * Formats the accessible roles in a container's tree as a readable string,
+ * listing each role together with its widgets and their accessible names.
  *
- * @param container - The container to format roles for
- * @returns Formatted string showing all roles and their accessible names
+ * @param container The scope to inspect.
  */
 export declare const prettyRoles: (container: Container) => string;
 /**
- * Logs all accessible roles in a container to the console.
- *
- * Useful for debugging test failures and discovering available roles.
- *
- * @param container - The container to log roles for
- *
- * @example
- * ```tsx
- * import { render, logRoles } from "@gtkx/testing";
+ * Prints the accessible roles in a container's tree to the console using
+ * {@link prettyRoles}.
  *
- * const { container } = await render(<MyComponent />);
- * logRoles(container);
- * // Console output:
- * // button:
- * //   Name "Submit": <GtkButton role="button">Submit</GtkButton>
- * //   Name "Cancel": <GtkButton role="button">Cancel</GtkButton>
- * // checkbox:
- * //   Name "Remember me": <GtkCheckButton role="checkbox">Remember me</GtkCheckButton>
- * ```
+ * @param container The scope to inspect.
  */
 export declare const logRoles: (container: Container) => void;
 //# 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,eAAe,CAAC;AACrC,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,gBAAgB,CAAC;AAG1D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACnB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,GAAG,CAAC,cAAc,GAAG,SAAS,KAAG,MAKjE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,SAAS,KAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAoBrE,CAAC;AASF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,SAAS,KAAG,MAoBlD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,SAAS,KAAG,IAE/C,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;AAY1D;;;;;GAKG;AACH,eAAO,MAAM,UAAU,SAAU,GAAG,CAAC,cAAc,KAAG,MAIrD,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,KAAG,MAWpE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,cAAe,SAAS,KAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAevE,CAAC;AASF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAoBlD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,cAAe,SAAS,KAAG,IAE/C,CAAC"}

package/dist/role-helpers.js

@@ -1,70 +1,66 @@
-import * as Gtk from "@gtkx/ffi/gtk";
+import * as Gtk from "@gtkx/gi/gtk";
+import { sortStringsBy } from "@gtkx/utils";
 import { traverse } from "./traversal.js";
-import { getWidgetAccessibleName } from "./widget-text.js";
+import { getWidgetAccessibleName } from "./widget-accessible-properties.js";
+const enumNamesByValue = (enumObject) => new Map(Object.entries(enumObject)
+    .filter((entry) => typeof entry[1] === "number")
+    .map(([name, value]) => [value, name]));
+const ROLE_NAMES_BY_VALUE = enumNamesByValue(Gtk.AccessibleRole);
 /**
- * Formats a GTK accessible role to a lowercase string.
+ * Converts an accessible role enum value into its lowercase name, falling back
+ * to the numeric value when the role is unknown.
  *
- * @param role - The GTK accessible role
- * @returns Lowercase role name (e.g., "button", "checkbox")
+ * @param role The accessible role to format.
  */
 export const formatRole = (role) => {
-    if (role === undefined)
-        return "unknown";
-    const name = Gtk.AccessibleRole[role];
+    const name = ROLE_NAMES_BY_VALUE.get(role);
     if (!name)
         return String(role);
     return name.toLowerCase();
 };
+export const formatRoleList = (roles) => {
+    const names = [...roles].map((role) => formatRole(role).toUpperCase());
+    if (names.length <= 1) {
+        return names.join("");
+    }
+    if (names.length === 2) {
+        return `${names[0]} or ${names[1]}`;
+    }
+    const head = names.slice(0, -1);
+    const last = names[names.length - 1];
+    return `${head.join(", ")}, or ${last}`;
+};
 /**
- * Collects all accessible roles and their widgets from a container.
- *
- * Returns a Map where keys are role names (lowercase) and values are
- * arrays of widgets with that role, including their accessible names.
- *
- * @param container - The container to scan for roles
- * @returns Map of role names to arrays of RoleInfo
+ * Groups every widget in a container's tree by its accessible role name.
  *
- * @example
- * ```tsx
- * import { getRoles } from "@gtkx/testing";
- *
- * const roles = getRoles(container);
- * // Map {
- * //   "button" => [{ widget: ..., name: "Submit" }, { widget: ..., name: "Cancel" }],
- * //   "checkbox" => [{ widget: ..., name: "Remember me" }]
- * // }
- * ```
+ * @param container The scope to traverse.
+ * @returns A map from role name to the widgets that have that role.
  */
 export const getRoles = (container) => {
     const roles = new Map();
     for (const widget of traverse(container)) {
-        const role = widget.getAccessibleRole?.();
-        if (role === undefined)
-            continue;
-        const roleName = formatRole(role);
-        const name = getWidgetAccessibleName(widget);
-        const info = { widget, name };
+        const roleName = formatRole(widget.getAccessibleRole());
         const existing = roles.get(roleName);
         if (existing) {
-            existing.push(info);
+            existing.push(widget);
         }
         else {
-            roles.set(roleName, [info]);
+            roles.set(roleName, [widget]);
         }
     }
     return roles;
 };
 const formatWidgetPreview = (widget, name) => {
     const tagName = widget.constructor.name;
-    const roleAttr = formatRole(widget.getAccessibleRole?.());
+    const roleAttr = formatRole(widget.getAccessibleRole());
     const nameDisplay = name ? `Name "${name}"` : 'Name ""';
     return `${nameDisplay}: <${tagName} role="${roleAttr}">${name ?? ""}</${tagName}>`;
 };
 /**
- * Formats roles into a readable string for error messages.
+ * Formats the accessible roles in a container's tree as a readable string,
+ * listing each role together with its widgets and their accessible names.
  *
- * @param container - The container to format roles for
- * @returns Formatted string showing all roles and their accessible names
+ * @param container The scope to inspect.
  */
 export const prettyRoles = (container) => {
     const roles = getRoles(container);
@@ -72,36 +68,21 @@ export const prettyRoles = (container) => {
         return "No accessible roles found in the widget tree.";
     }
     const lines = [];
-    const sortedRoles = [...roles.entries()].sort(([a], [b]) => a.localeCompare(b));
+    const sortedRoles = sortStringsBy([...roles.entries()], ([roleName]) => roleName);
     for (const [roleName, widgets] of sortedRoles) {
         lines.push(`${roleName}:`);
-        for (const { widget, name } of widgets) {
-            lines.push(`  ${formatWidgetPreview(widget, name)}`);
+        for (const widget of widgets) {
+            lines.push(`  ${formatWidgetPreview(widget, getWidgetAccessibleName(widget))}`);
         }
         lines.push("");
     }
     return lines.join("\n").trimEnd();
 };
 /**
- * Logs all accessible roles in a container to the console.
- *
- * Useful for debugging test failures and discovering available roles.
- *
- * @param container - The container to log roles for
- *
- * @example
- * ```tsx
- * import { render, logRoles } from "@gtkx/testing";
+ * Prints the accessible roles in a container's tree to the console using
+ * {@link prettyRoles}.
  *
- * const { container } = await render(<MyComponent />);
- * logRoles(container);
- * // Console output:
- * // button:
- * //   Name "Submit": <GtkButton role="button">Submit</GtkButton>
- * //   Name "Cancel": <GtkButton role="button">Cancel</GtkButton>
- * // checkbox:
- * //   Name "Remember me": <GtkCheckButton role="checkbox">Remember me</GtkCheckButton>
- * ```
+ * @param container The scope to inspect.
  */
 export const logRoles = (container) => {
     console.log(prettyRoles(container));

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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"}
+{"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 enumNamesByValue = (enumObject: Record<string, string | number>): Map<number, string> =>\n    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\nconst ROLE_NAMES_BY_VALUE = enumNamesByValue(Gtk.AccessibleRole);\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 */\nexport const formatRole = (role: Gtk.AccessibleRole): string => {\n    const name = ROLE_NAMES_BY_VALUE.get(role);\n    if (!name) return String(role);\n    return name.toLowerCase();\n};\n\nexport const formatRoleList = (roles: Iterable<Gtk.AccessibleRole>): string => {\n    const names = [...roles].map((role) => formatRole(role).toUpperCase());\n    if (names.length <= 1) {\n        return names.join(\"\");\n    }\n    if (names.length === 2) {\n        return `${names[0]} or ${names[1]}`;\n    }\n    const head = names.slice(0, -1);\n    const last = names[names.length - 1];\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 */\nexport const getRoles = (container: Container): Map<string, Gtk.Widget[]> => {\n    const roles = new Map<string, Gtk.Widget[]>();\n\n    for (const widget of traverse(container)) {\n        const roleName = formatRole(widget.getAccessibleRole());\n\n        const existing = roles.get(roleName);\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    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 */\nexport const 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\n    const sortedRoles = sortStringsBy([...roles.entries()], ([roleName]) => roleName);\n\n    for (const [roleName, widgets] of sortedRoles) {\n        lines.push(`${roleName}:`);\n        for (const widget of widgets) {\n            lines.push(`  ${formatWidgetPreview(widget, getWidgetAccessibleName(widget))}`);\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 */\nexport const logRoles = (container: Container): void => {\n    console.log(prettyRoles(container));\n};\n"]}

package/dist/screen.d.ts

@@ -1,66 +1,9 @@
-import * as Gtk from "@gtkx/ffi/gtk";
-import { type ScreenshotOptions } from "./screenshot.js";
-import type { ScreenshotResult } from "./types.js";
-/** @internal */
-export declare const setScreenRoot: (root: Gtk.Application | null) => void;
+import type { RenderResult, Screen } from "./bound-queries.js";
 /**
- * Global query object for accessing rendered components.
- *
- * Provides the same query methods as render result, but automatically
- * uses the most recently rendered application as the container.
- *
- * @example
- * ```tsx
- * import { render, screen } from "@gtkx/testing";
- *
- * test("finds button", async () => {
- *   await render(<MyComponent />);
- *   const button = await screen.findByRole(Gtk.AccessibleRole.BUTTON);
- *   expect(button).toBeDefined();
- * });
- * ```
- *
- * @see {@link render} for rendering components
- * @see {@link within} for scoped queries
+ * Queries and debug utilities bound to the most recent render, scoped to the
+ * current toplevel windows. Accessing it before any render throws.
  */
-export declare const screen: {
-    /** Print the widget tree to console for debugging */
-    debug: () => void;
-    /** Log all accessible roles to console for debugging */
-    logRoles: () => void;
-    /**
-     * Capture a screenshot of the application window, saving it to a temporary file and logging the file path.
-     *
-     * @param selector - Window selector: index (number), title substring (string), or title pattern (RegExp).
-     *                   If omitted, captures the first window.
-     * @param options - Optional timeout and interval configuration for waiting on widget rendering.
-     * @returns Screenshot result containing base64-encoded PNG data
-     * @throws Error if no windows are available or no matching window is found
-     *
-     * @example
-     * ```tsx
-     * await screen.screenshot();              // First window
-     * await screen.screenshot(0);             // Window at index 0
-     * await screen.screenshot("Settings");    // Window with title containing "Settings"
-     * await screen.screenshot(/^My App/);     // Window with title matching regex
-     * ```
-     */
-    screenshot: (selector?: number | string | RegExp, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
-    queryByRole: (role: Gtk.AccessibleRole, options?: import("./types.js").ByRoleOptions) => Gtk.Widget | null;
-    queryByLabelText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Gtk.Widget | null;
-    queryByText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Gtk.Widget | null;
-    queryByName: (name: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Gtk.Widget | null;
-    queryAllByRole: (role: Gtk.AccessibleRole, options?: import("./types.js").ByRoleOptions) => Gtk.Widget[];
-    queryAllByLabelText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Gtk.Widget[];
-    queryAllByText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Gtk.Widget[];
-    queryAllByName: (name: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Gtk.Widget[];
-    findByRole: (role: Gtk.AccessibleRole, options?: import("./types.js").ByRoleOptions) => Promise<Gtk.Widget>;
-    findByLabelText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Promise<Gtk.Widget>;
-    findByText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Promise<Gtk.Widget>;
-    findByName: (name: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Promise<Gtk.Widget>;
-    findAllByRole: (role: Gtk.AccessibleRole, options?: import("./types.js").ByRoleOptions) => Promise<Gtk.Widget[]>;
-    findAllByLabelText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Promise<Gtk.Widget[]>;
-    findAllByText: (text: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Promise<Gtk.Widget[]>;
-    findAllByName: (name: import("./types.js").TextMatch, options?: import("./types.js").TextMatchOptions) => Promise<Gtk.Widget[]>;
-};
+export declare const screen: Screen;
+export declare const setScreen: (result: RenderResult) => void;
+export declare const clearScreen: () => void;
 //# sourceMappingURL=screen.d.ts.map

package/dist/screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAIrC,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqBnD,gBAAgB;AAChB,eAAO,MAAM,aAAa,GAAI,MAAM,GAAG,CAAC,WAAW,GAAG,IAAI,KAAG,IAE5D,CAAC;AAYF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM;IAEf,qDAAqD;;IAIrD,wDAAwD;;IAIxD;;;;;;;;;;;;;;;;OAgBG;4BAC2B,MAAM,GAAG,MAAM,GAAG,MAAM,YAAY,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAAC;mDAS3G,CAAA;oEAG0B,CAAC;+DAI3B,CAAL;+DAGqC,CAAC;sDAIV,CAAC;uEAGpB,CAAJ;kEAQF,CAAC;kEAAmK,CAAC;kDAAyK,CAAC;mEAA4K,CAAC;8DAAoK,CAAC;8DAAmK,CAAC;qDAAkL,CAAC;sEAAgL,CAAC;iEAAwK,CAAC;iEAAuK,CAAC;CAD//C,CAAC"}
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiB/D;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAEnB,CAAC;AAEH,eAAO,MAAM,SAAS,WAAY,YAAY,KAAG,IAEhD,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAC"}

package/dist/screen.js

@@ -1,114 +1,26 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import * as Gtk from "@gtkx/ffi/gtk";
-import { bindQueries } from "./bind-queries.js";
-import { prettyWidget } from "./pretty-widget.js";
-import { logRoles } from "./role-helpers.js";
-import { screenshot as screenshotWidget } from "./screenshot.js";
-const getScreenshotDir = () => {
-    const dir = join(tmpdir(), "gtkx-screenshots");
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    return dir;
+const NO_RENDER_MESSAGE = "No render has been performed: call render() before using screen queries";
+const throwNoRender = () => {
+    throw new Error(NO_RENDER_MESSAGE);
 };
-const saveAndLogScreenshot = (result) => {
-    const dir = getScreenshotDir();
-    const filename = `${Date.now()}-screenshot.png`;
-    const filepath = join(dir, filename);
-    const buffer = Buffer.from(result.data, "base64");
-    writeFileSync(filepath, buffer);
-    console.log(`Screenshot saved: file://${filepath}`);
-};
-let currentRoot = null;
-/** @internal */
-export const setScreenRoot = (root) => {
-    currentRoot = root;
-};
-const getRoot = () => {
-    if (!currentRoot) {
-        throw new Error("No render has been performed: call render() before using screen queries");
-    }
-    return currentRoot;
-};
-const boundQueries = bindQueries(getRoot);
+const defaultScreen = new Proxy({}, {
+    get: (_target, property) => {
+        if (property === "baseElement" || property === "container")
+            return throwNoRender();
+        return throwNoRender;
+    },
+});
+let activeScreen = defaultScreen;
 /**
- * Global query object for accessing rendered components.
- *
- * Provides the same query methods as render result, but automatically
- * uses the most recently rendered application as the container.
- *
- * @example
- * ```tsx
- * import { render, screen } from "@gtkx/testing";
- *
- * test("finds button", async () => {
- *   await render(<MyComponent />);
- *   const button = await screen.findByRole(Gtk.AccessibleRole.BUTTON);
- *   expect(button).toBeDefined();
- * });
- * ```
- *
- * @see {@link render} for rendering components
- * @see {@link within} for scoped queries
+ * Queries and debug utilities bound to the most recent render, scoped to the
+ * current toplevel windows. Accessing it before any render throws.
  */
-export const screen = {
-    ...boundQueries,
-    /** Print the widget tree to console for debugging */
-    debug: () => {
-        console.log(prettyWidget(getRoot()));
-    },
-    /** Log all accessible roles to console for debugging */
-    logRoles: () => {
-        logRoles(getRoot());
-    },
-    /**
-     * Capture a screenshot of the application window, saving it to a temporary file and logging the file path.
-     *
-     * @param selector - Window selector: index (number), title substring (string), or title pattern (RegExp).
-     *                   If omitted, captures the first window.
-     * @param options - Optional timeout and interval configuration for waiting on widget rendering.
-     * @returns Screenshot result containing base64-encoded PNG data
-     * @throws Error if no windows are available or no matching window is found
-     *
-     * @example
-     * ```tsx
-     * await screen.screenshot();              // First window
-     * await screen.screenshot(0);             // Window at index 0
-     * await screen.screenshot("Settings");    // Window with title containing "Settings"
-     * await screen.screenshot(/^My App/);     // Window with title matching regex
-     * ```
-     */
-    screenshot: async (selector, options) => {
-        const windows = Gtk.Window.listToplevels();
-        if (windows.length === 0) {
-            throw new Error("No windows available for screenshot");
-        }
-        let targetWindow;
-        if (selector === undefined) {
-            targetWindow = windows[0];
-        }
-        else if (typeof selector === "number") {
-            targetWindow = windows[selector];
-            if (!targetWindow) {
-                throw new Error(`Window at index ${selector} not found`);
-            }
-        }
-        else {
-            const isRegex = selector instanceof RegExp;
-            targetWindow = windows.find((w) => {
-                const title = w.getTitle() ?? "";
-                return isRegex ? selector.test(title) : title.includes(selector);
-            });
-            if (!targetWindow) {
-                const pattern = isRegex ? selector.toString() : `"${selector}"`;
-                throw new Error(`No window found with title matching ${pattern}`);
-            }
-        }
-        const result = await screenshotWidget(targetWindow, options);
-        saveAndLogScreenshot(result);
-        return result;
-    },
+export const screen = new Proxy({}, {
+    get: (_target, property) => Reflect.get(activeScreen, property),
+});
+export const setScreen = (result) => {
+    activeScreen = result;
+};
+export const clearScreen = () => {
+    activeScreen = defaultScreen;
 };
 //# sourceMappingURL=screen.js.map

package/dist/screen.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAA0B,UAAU,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGzF,MAAM,gBAAgB,GAAG,GAAW,EAAE;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,MAAwB,EAAQ,EAAE;IAC5D,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,IAAI,WAAW,GAA2B,IAAI,CAAC;AAE/C,gBAAgB;AAChB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAA4B,EAAQ,EAAE;IAChE,WAAW,GAAG,IAAI,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,GAAoB,EAAE;IAClC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,GAAG,YAAY;IACf,qDAAqD;IACrD,KAAK,EAAE,GAAG,EAAE;QACR,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,wDAAwD;IACxD,QAAQ,EAAE,GAAG,EAAE;QACX,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACxB,CAAC;IACD;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,EAAE,KAAK,EAAE,QAAmC,EAAE,OAA2B,EAA6B,EAAE;QAC9G,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAE3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,YAAoC,CAAC;QAEzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,YAAY,GAAG,OAAO,CAAC,CAAC,CAAe,CAAC;QAC5C,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,YAAY,GAAG,OAAO,CAAC,QAAQ,CAA2B,CAAC;YAC3D,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,YAAY,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,OAAO,GAAG,QAAQ,YAAY,MAAM,CAAC;YAC3C,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC9B,MAAM,KAAK,GAAI,CAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrE,CAAC,CAA2B,CAAC;YAE7B,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC7D,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ,CAAC"}
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,yEAAyE,CAAC;AAEpG,MAAM,aAAa,GAAG,GAAU,EAAE;IAC9B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,aAAa,GAAiB,IAAI,KAAK,CAAC,EAAkB,EAAE;IAC9D,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QACvB,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,WAAW;YAAE,OAAO,aAAa,EAAE,CAAC;QACnF,OAAO,aAAa,CAAC;IACzB,CAAC;CACJ,CAAC,CAAC;AAEH,IAAI,YAAY,GAAiB,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,IAAI,KAAK,CAAC,EAAY,EAAE;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAoB,EAAQ,EAAE;IACpD,YAAY,GAAG,MAAM,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAS,EAAE;IAClC,YAAY,GAAG,aAAa,CAAC;AACjC,CAAC,CAAC","sourcesContent":["import type { RenderResult, Screen } from \"./bound-queries.js\";\n\nconst NO_RENDER_MESSAGE = \"No render has been performed: call render() before using screen queries\";\n\nconst throwNoRender = (): never => {\n    throw new Error(NO_RENDER_MESSAGE);\n};\n\nconst defaultScreen: RenderResult = new Proxy({} as RenderResult, {\n    get: (_target, property) => {\n        if (property === \"baseElement\" || property === \"container\") return throwNoRender();\n        return throwNoRender;\n    },\n});\n\nlet activeScreen: RenderResult = defaultScreen;\n\n/**\n * Queries and debug utilities bound to the most recent render, scoped to the\n * current toplevel windows. Accessing it before any render throws.\n */\nexport const screen: Screen = new Proxy({} as Screen, {\n    get: (_target, property) => Reflect.get(activeScreen, property),\n});\n\nexport const setScreen = (result: RenderResult): void => {\n    activeScreen = result;\n};\n\nexport const clearScreen = (): void => {\n    activeScreen = defaultScreen;\n};\n"]}

package/dist/screenshot.d.ts

@@ -1,30 +1,27 @@
-import * as Gtk from "@gtkx/ffi/gtk";
-import type { ScreenshotResult, WaitForOptions } from "./types.js";
+import * as Gtk from "@gtkx/gi/gtk";
+import type { ScreenshotOptions, ScreenshotResult, WindowSelector } from "./types.js";
 /**
- * Options for capturing widget screenshots.
+ * Captures a PNG snapshot of a widget, retrying until it has a paintable size.
+ *
+ * @param widget The widget to render to an image.
+ * @param options Optional scale, timeout, and retry interval.
+ * @returns The base64-encoded PNG data along with its mime type and dimensions.
  */
-export type ScreenshotOptions = Pick<WaitForOptions, "timeout" | "interval">;
+export declare const screenshot: (widget: Gtk.Widget, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
 /**
- * Captures a screenshot of a GTK widget as a PNG image.
- *
- * This function will retry multiple times if the widget hasn't finished
- * rendering, waiting for GTK to complete its paint cycle.
- *
- * @param widget - The widget to capture (typically a Window)
- * @param options - Optional timeout and interval configuration
- * @returns Screenshot result containing base64-encoded PNG data and dimensions
- * @throws Error if widget has no size, is not realized, or rendering fails after timeout
+ * Prints a clickable file URL for a saved screenshot to the console.
  *
- * @example
- * ```tsx
- * import { render, screenshot } from "@gtkx/testing";
- * import * as Gtk from "@gtkx/ffi/gtk";
+ * @param filepath Absolute path of the saved screenshot file.
+ */
+export 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.
  *
- * const { container } = await render(<MyApp />);
- * const window = container.getWindows()[0];
- * const result = await screenshot(window);
- * console.log(result.mimeType); // "image/png"
- * ```
+ * @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.
  */
-export declare const screenshot: (widget: Gtk.Widget, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
+export declare const captureAndSaveScreenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
 //# 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":"AAEA,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwDnE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,UAAU,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAiB1G,CAAC"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuDtF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,WAAkB,GAAG,CAAC,MAAM,YAAY,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAW1G,CAAC;AAiDF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAAc,MAAM,KAAG,IAEpD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,cACtB,cAAc,YACf,iBAAiB,KAC5B,OAAO,CAAC,gBAAgB,CAK1B,CAAC"}