@gtkx/testing 1.0.0-rc.4 → 1.1.0

package/dist/widget-getters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-getters.d.ts","sourceRoot":"","sources":["../src/widget-getters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAQzC,QAAA,MAAM,iBAAiB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAAyC,CAAC;AA2BnG,QAAA,MAAM,UAAU,GAAI,QAAQ,OAAO,CAAC,MAAM,KAAG,MAU5C,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,MAAM,KAAG,OACL,CAAC;AAE5D,QAAA,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,MAAM,KAAG,OACL,CAAC;AAGxD,QAAA,MAAM,iBAAiB,GAAI,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACrD,QAAQ,GAAG,CAAC,MAAM,EAClB,MAAM,MAAM,KACb,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,GAAG,IAIhC,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,GAAG,IAIzE,CAAC;AAEF,QAAA,MAAM,gBAAgB,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,KAAG,MAAM,GAAG,IAIvE,CAAC;AAEF,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACtB,CAAC"}

package/dist/widget-getters.js

@@ -0,0 +1,46 @@
+import { getClassType, getInstanceType, TYPE_INVALID, typeName } from "@gtkx/runtime";
+import { resolveWrapperClass } from "@gtkx/runtime/internal";
+import { walkClassChain } from "@gtkx/utils";
+const UNNAMED_TYPE_TAG = "Object";
+const getWidgetMethod = (widget, name) => Reflect.get(widget, name);
+const getWidgetTypeName = (widget) => typeName(getInstanceType(widget));
+const isClass = (value) => typeof value === "function";
+const nonEmpty = (value) => typeof value === "string" && value.length > 0 ? value : undefined;
+const getObjectClass = (object) => {
+    const cls = object.constructor;
+    return isClass(cls) ? cls : null;
+};
+const getNearestClassName = (object) => walkClassChain(getObjectClass(object), (ancestor) => nonEmpty(ancestor.name));
+const getUntypedClassName = (object) => {
+    const cls = getObjectClass(object);
+    return cls !== null && getClassType(cls) === TYPE_INVALID ? nonEmpty(cls.name) : undefined;
+};
+const getExactWrapperName = (type) => {
+    const wrapper = resolveWrapperClass(type);
+    return wrapper !== null && getClassType(wrapper) === type ? nonEmpty(wrapper.name) : undefined;
+};
+const getTypeTag = (object) => {
+    const type = getInstanceType(object);
+    return (getUntypedClassName(object) ??
+        getExactWrapperName(type) ??
+        nonEmpty(typeName(type)) ??
+        getNearestClassName(object) ??
+        UNNAMED_TYPE_TAG);
+};
+const isDefaultWidgetName = (widget, name) => name.length === 0 || name === getWidgetTypeName(widget);
+const hasWidgetMethod = (widget, name) => typeof getWidgetMethod(widget, name) === "function";
+/* eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- callers name the signature */
+const getCallableMethod = (widget, name) => {
+    const fn = getWidgetMethod(widget, name);
+    return typeof fn === "function" ? fn.bind(widget) : null;
+};
+const callBooleanGetter = (widget, method) => {
+    const value = getCallableMethod(widget, method)?.();
+    return typeof value === "boolean" ? value : null;
+};
+const callStringGetter = (widget, method) => {
+    const value = getCallableMethod(widget, method)?.();
+    return typeof value === "string" ? value : null;
+};
+export { callBooleanGetter, callStringGetter, getCallableMethod, getTypeTag, getWidgetTypeName, hasWidgetMethod, isDefaultWidgetName, };
+//# sourceMappingURL=widget-getters.js.map

package/dist/widget-getters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-getters.js","sourceRoot":"","sources":["../src/widget-getters.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport type * as Gtk from \"@gtkx/gi/gtk\";\nimport { getClassType, getInstanceType, TYPE_INVALID, typeName } from \"@gtkx/runtime\";\nimport { resolveWrapperClass } from \"@gtkx/runtime/internal\";\nimport { type AnyClass, walkClassChain } from \"@gtkx/utils\";\n\nconst UNNAMED_TYPE_TAG = \"Object\";\n\nconst getWidgetMethod = (widget: Gtk.Widget, name: string): unknown => Reflect.get(widget, name);\nconst getWidgetTypeName = (widget: Gtk.Widget): string | null => typeName(getInstanceType(widget));\nconst isClass = (value: unknown): value is AnyClass => typeof value === \"function\";\n\nconst nonEmpty = (value: unknown): string | undefined =>\n    typeof value === \"string\" && value.length > 0 ? value : undefined;\n\nconst getObjectClass = (object: GObject.Object): AnyClass | null => {\n    const cls: unknown = object.constructor;\n\n    return isClass(cls) ? cls : null;\n};\n\nconst getNearestClassName = (object: GObject.Object): string | undefined =>\n    walkClassChain(getObjectClass(object), (ancestor) => nonEmpty(ancestor.name));\n\nconst getUntypedClassName = (object: GObject.Object): string | undefined => {\n    const cls = getObjectClass(object);\n\n    return cls !== null && getClassType(cls) === TYPE_INVALID ? nonEmpty(cls.name) : undefined;\n};\n\nconst getExactWrapperName = (type: bigint): string | undefined => {\n    const wrapper = resolveWrapperClass(type);\n\n    return wrapper !== null && getClassType(wrapper) === type ? nonEmpty(wrapper.name) : undefined;\n};\n\nconst getTypeTag = (object: GObject.Object): string => {\n    const type = getInstanceType(object);\n\n    return (\n        getUntypedClassName(object) ??\n        getExactWrapperName(type) ??\n        nonEmpty(typeName(type)) ??\n        getNearestClassName(object) ??\n        UNNAMED_TYPE_TAG\n    );\n};\n\nconst isDefaultWidgetName = (widget: Gtk.Widget, name: string): boolean =>\n    name.length === 0 || name === getWidgetTypeName(widget);\n\nconst hasWidgetMethod = (widget: Gtk.Widget, name: string): boolean =>\n    typeof getWidgetMethod(widget, name) === \"function\";\n\n/* eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- callers name the signature */\nconst getCallableMethod = <Args extends unknown[], Result>(\n    widget: Gtk.Widget,\n    name: string,\n): ((...args: Args) => Result) | null => {\n    const fn = getWidgetMethod(widget, name);\n\n    return typeof fn === \"function\" ? (fn as (...args: Args) => Result).bind(widget) : null;\n};\n\nconst callBooleanGetter = (widget: Gtk.Widget, method: string): boolean | null => {\n    const value = getCallableMethod<[], unknown>(widget, method)?.();\n\n    return typeof value === \"boolean\" ? value : null;\n};\n\nconst callStringGetter = (widget: Gtk.Widget, method: string): string | null => {\n    const value = getCallableMethod<[], unknown>(widget, method)?.();\n\n    return typeof value === \"string\" ? value : null;\n};\n\nexport {\n    callBooleanGetter,\n    callStringGetter,\n    getCallableMethod,\n    getTypeTag,\n    getWidgetTypeName,\n    hasWidgetMethod,\n    isDefaultWidgetName,\n};\n"]}

package/dist/window-state.d.ts

@@ -0,0 +1,10 @@
+import * as Gtk from "@gtkx/gi/gtk";
+declare const mappedToplevels: () => Gtk.Window[];
+declare const isWindowAllocated: (window: Gtk.Window) => boolean;
+declare const activeToplevel: () => Gtk.Window | null;
+declare const isWindowActivated: (window: Gtk.Window) => boolean;
+declare const isWindowBlockedByModal: (window: Gtk.Window) => boolean;
+declare const findPresentedWindowFailure: (window: Gtk.Window) => string | null;
+declare const findRenderedWindowFailure: (window: Gtk.Window) => string | null;
+export { activeToplevel, findPresentedWindowFailure, findRenderedWindowFailure, isWindowActivated, isWindowAllocated, isWindowBlockedByModal, mappedToplevels, };
+//# sourceMappingURL=window-state.d.ts.map

package/dist/window-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-state.d.ts","sourceRoot":"","sources":["../src/window-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AASpC,QAAA,MAAM,eAAe,QAAO,GAAG,CAAC,MAAM,EACoE,CAAC;AAE3G,QAAA,MAAM,iBAAiB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAI/C,CAAC;AAEF,QAAA,MAAM,cAAc,QAAO,GAAG,CAAC,MAAM,GAAG,IAAyE,CAAC;AAElH,QAAA,MAAM,iBAAiB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OACa,CAAC;AAqB9D,QAAA,MAAM,sBAAsB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAC0B,CAAC;AAEhF,QAAA,MAAM,0BAA0B,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAMjE,CAAC;AAEF,QAAA,MAAM,yBAAyB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAMhE,CAAC;AAEF,OAAO,EACH,cAAc,EACd,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,GAClB,CAAC"}

package/dist/window-state.js

@@ -0,0 +1,41 @@
+import * as Gtk from "@gtkx/gi/gtk";
+const WINDOW_NOT_ALLOCATED = "it was never allocated a size";
+const WINDOW_NOT_ACTIVATED = "it never became active";
+const NO_WINDOW_ACTIVATED = "no window of the application ever became active";
+const canDisplayDeliverActivation = (window) => window.getDisplay().getDefaultSeat() !== null;
+const isWindow = (widget) => widget instanceof Gtk.Window;
+const mappedToplevels = () => Gtk.Window.listToplevels().filter((widget) => isWindow(widget)).filter((window) => window.getMapped());
+const isWindowAllocated = (window) => {
+    const [isComputed, allocation] = window.computeBounds(window);
+    return isComputed && allocation.getWidth() > 0;
+};
+const activeToplevel = () => mappedToplevels().find((toplevel) => toplevel.isActive()) ?? null;
+const isWindowActivated = (window) => !canDisplayDeliverActivation(window) || window.isActive();
+const isApplicationActivated = (window) => !canDisplayDeliverActivation(window) || activeToplevel() !== null;
+const isTransientDescendant = (window, ancestor) => {
+    for (let parent = window.getTransientFor(); parent !== null; parent = parent.getTransientFor()) {
+        if (parent === ancestor) {
+            return true;
+        }
+    }
+    return false;
+};
+const isModalGrabHeldOver = (modal, window) => modal.getModal() &&
+    modal !== window &&
+    modal.getGroup() === window.getGroup() &&
+    !isTransientDescendant(window, modal);
+const isWindowBlockedByModal = (window) => mappedToplevels().some((toplevel) => isModalGrabHeldOver(toplevel, window));
+const findPresentedWindowFailure = (window) => {
+    if (!isWindowAllocated(window)) {
+        return WINDOW_NOT_ALLOCATED;
+    }
+    return isWindowActivated(window) ? null : WINDOW_NOT_ACTIVATED;
+};
+const findRenderedWindowFailure = (window) => {
+    if (!isWindowAllocated(window)) {
+        return WINDOW_NOT_ALLOCATED;
+    }
+    return isApplicationActivated(window) ? null : NO_WINDOW_ACTIVATED;
+};
+export { activeToplevel, findPresentedWindowFailure, findRenderedWindowFailure, isWindowActivated, isWindowAllocated, isWindowBlockedByModal, mappedToplevels, };
+//# sourceMappingURL=window-state.js.map

package/dist/window-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-state.js","sourceRoot":"","sources":["../src/window-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAC7D,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AACtD,MAAM,mBAAmB,GAAG,iDAAiD,CAAC;AAE9E,MAAM,2BAA2B,GAAG,CAAC,MAAkB,EAAW,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,cAAc,EAAE,KAAK,IAAI,CAAC;AACnH,MAAM,QAAQ,GAAG,CAAC,MAAkB,EAAwB,EAAE,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC;AAE5F,MAAM,eAAe,GAAG,GAAiB,EAAE,CACvC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;AAE3G,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAW,EAAE;IACtD,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAE9D,OAAO,UAAU,IAAI,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,GAAsB,EAAE,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC;AAElH,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAW,EAAE,CACtD,CAAC,2BAA2B,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;AAE9D,MAAM,sBAAsB,GAAG,CAAC,MAAkB,EAAW,EAAE,CAC3D,CAAC,2BAA2B,CAAC,MAAM,CAAC,IAAI,cAAc,EAAE,KAAK,IAAI,CAAC;AAEtE,MAAM,qBAAqB,GAAG,CAAC,MAAkB,EAAE,QAAoB,EAAW,EAAE;IAChF,KAAK,IAAI,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC;QAC7F,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,KAAiB,EAAE,MAAkB,EAAW,EAAE,CAC3E,KAAK,CAAC,QAAQ,EAAE;IAChB,KAAK,KAAK,MAAM;IAChB,KAAK,CAAC,QAAQ,EAAE,KAAK,MAAM,CAAC,QAAQ,EAAE;IACtC,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,MAAM,sBAAsB,GAAG,CAAC,MAAkB,EAAW,EAAE,CAC3D,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhF,MAAM,0BAA0B,GAAG,CAAC,MAAkB,EAAiB,EAAE;IACrE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,oBAAoB,CAAC;IAChC,CAAC;IAED,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,CAAC,MAAkB,EAAiB,EAAE;IACpE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,oBAAoB,CAAC;IAChC,CAAC;IAED,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACvE,CAAC,CAAC;AAEF,OAAO,EACH,cAAc,EACd,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,GAClB,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\n\nconst WINDOW_NOT_ALLOCATED = \"it was never allocated a size\";\nconst WINDOW_NOT_ACTIVATED = \"it never became active\";\nconst NO_WINDOW_ACTIVATED = \"no window of the application ever became active\";\n\nconst canDisplayDeliverActivation = (window: Gtk.Window): boolean => window.getDisplay().getDefaultSeat() !== null;\nconst isWindow = (widget: Gtk.Widget): widget is Gtk.Window => widget instanceof Gtk.Window;\n\nconst mappedToplevels = (): Gtk.Window[] =>\n    Gtk.Window.listToplevels().filter((widget) => isWindow(widget)).filter((window) => window.getMapped());\n\nconst isWindowAllocated = (window: Gtk.Window): boolean => {\n    const [isComputed, allocation] = window.computeBounds(window);\n\n    return isComputed && allocation.getWidth() > 0;\n};\n\nconst activeToplevel = (): Gtk.Window | null => mappedToplevels().find((toplevel) => toplevel.isActive()) ?? null;\n\nconst isWindowActivated = (window: Gtk.Window): boolean =>\n    !canDisplayDeliverActivation(window) || window.isActive();\n\nconst isApplicationActivated = (window: Gtk.Window): boolean =>\n    !canDisplayDeliverActivation(window) || activeToplevel() !== null;\n\nconst isTransientDescendant = (window: Gtk.Window, ancestor: Gtk.Window): boolean => {\n    for (let parent = window.getTransientFor(); parent !== null; parent = parent.getTransientFor()) {\n        if (parent === ancestor) {\n            return true;\n        }\n    }\n\n    return false;\n};\n\nconst isModalGrabHeldOver = (modal: Gtk.Window, window: Gtk.Window): boolean =>\n    modal.getModal() &&\n    modal !== window &&\n    modal.getGroup() === window.getGroup() &&\n    !isTransientDescendant(window, modal);\n\nconst isWindowBlockedByModal = (window: Gtk.Window): boolean =>\n    mappedToplevels().some((toplevel) => isModalGrabHeldOver(toplevel, window));\n\nconst findPresentedWindowFailure = (window: Gtk.Window): string | null => {\n    if (!isWindowAllocated(window)) {\n        return WINDOW_NOT_ALLOCATED;\n    }\n\n    return isWindowActivated(window) ? null : WINDOW_NOT_ACTIVATED;\n};\n\nconst findRenderedWindowFailure = (window: Gtk.Window): string | null => {\n    if (!isWindowAllocated(window)) {\n        return WINDOW_NOT_ALLOCATED;\n    }\n\n    return isApplicationActivated(window) ? null : NO_WINDOW_ACTIVATED;\n};\n\nexport {\n    activeToplevel,\n    findPresentedWindowFailure,\n    findRenderedWindowFailure,\n    isWindowActivated,\n    isWindowAllocated,\n    isWindowBlockedByModal,\n    mappedToplevels,\n};\n"]}

package/dist/within.d.ts

@@ -3,12 +3,13 @@ import type { Container } from "./traversal.js";
 import type { BoundCustomQueries, QueryMap } from "./types.js";
 /**
  * Binds the built-in queries, and any custom queries, to a specific container
- * so they search only within that scope.
+ * so they search only within that scope. Also exported as `getQueriesForElement`,
+ * which reads better in library code.
  *
  * @param container The scope the returned queries operate on.
  * @param queries Optional custom queries to bind alongside the built-in ones.
  * @returns The queries bound to the container.
  */
 declare const within: <Q extends QueryMap = Record<never, never>>(container: Container, queries?: Q) => BoundQueries & BoundCustomQueries<Q>;
-export { within };
+export { within, within as getQueriesForElement };
 //# sourceMappingURL=within.d.ts.map

package/dist/within.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"within.d.ts","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAc/D;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM,GAAI,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACrD,WAAW,SAAS,EACpB,UAAU,CAAC,KACZ,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAGpC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"within.d.ts","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAc/D;;;;;;;;GAQG;AACH,QAAA,MAAM,MAAM,GAAI,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACrD,WAAW,SAAS,EACpB,UAAU,CAAC,KACZ,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAGpC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/within.js

@@ -6,7 +6,8 @@ const bindCustomQueries = (customQueries, container) => {
 };
 /**
  * Binds the built-in queries, and any custom queries, to a specific container
- * so they search only within that scope.
+ * so they search only within that scope. Also exported as `getQueriesForElement`,
+ * which reads better in library code.
  *
  * @param container The scope the returned queries operate on.
  * @param queries Optional custom queries to bind alongside the built-in ones.
@@ -16,5 +17,5 @@ const within = (container, queries) => ({
     ...bindCustomQueries(builtinQueries, container),
     ...(queries ? bindCustomQueries(queries, container) : {}),
 });
-export { within };
+export { within, within as getQueriesForElement };
 //# sourceMappingURL=within.js.map

package/dist/within.js.map

@@ -1 +1 @@
-{"version":3,"file":"within.js","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GACX,CAAiC,KAAsD,EAAE,SAAoB,EAAE,EAAE,CAC7G,CAAC,GAAG,IAAU,EAAU,EAAE,CACtB,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AAEtC,MAAM,iBAAiB,GAAG,CAAqB,aAAgB,EAAE,SAAoB,EAAyB,EAAE;IAC5G,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAU,CAAC,CAAC;IAEjH,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAA0B,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,CACX,SAAoB,EACpB,OAAW,EACyB,EAAE,CAAC,CAAC;IACxC,GAAI,iBAAiB,CAAC,cAAc,EAAE,SAAS,CAAkB;IACjE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAE,EAA4B,CAAC;CACvF,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["import type { BoundQueries } from \"./bound-queries.js\";\nimport type { Container } from \"./traversal.js\";\nimport type { BoundCustomQueries, QueryMap } from \"./types.js\";\nimport { builtinQueries } from \"./queries.js\";\n\nconst bindQuery =\n    <Args extends unknown[], Result>(query: (container: Container, ...args: Args) => Result, container: Container) =>\n        (...args: Args): Result =>\n            query(container, ...args);\n\nconst bindCustomQueries = <Q extends QueryMap>(customQueries: Q, container: Container): BoundCustomQueries<Q> => {\n    const entries = Object.entries(customQueries).map(([key, query]) => [key, bindQuery(query, container)] as const);\n\n    return Object.fromEntries(entries) as BoundCustomQueries<Q>;\n};\n\n/**\n * Binds the built-in queries, and any custom queries, to a specific container\n * so they search only within that scope.\n *\n * @param container The scope the returned queries operate on.\n * @param queries Optional custom queries to bind alongside the built-in ones.\n * @returns The queries bound to the container.\n */\nconst within = <Q extends QueryMap = Record<never, never>>(\n    container: Container,\n    queries?: Q,\n): BoundQueries & BoundCustomQueries<Q> => ({\n    ...(bindCustomQueries(builtinQueries, container) as BoundQueries),\n    ...(queries ? bindCustomQueries(queries, container) : ({} as BoundCustomQueries<Q>)),\n});\n\nexport { within };\n"]}
+{"version":3,"file":"within.js","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GACX,CAAiC,KAAsD,EAAE,SAAoB,EAAE,EAAE,CAC7G,CAAC,GAAG,IAAU,EAAU,EAAE,CACtB,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AAEtC,MAAM,iBAAiB,GAAG,CAAqB,aAAgB,EAAE,SAAoB,EAAyB,EAAE;IAC5G,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAU,CAAC,CAAC;IAEjH,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAA0B,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,GAAG,CACX,SAAoB,EACpB,OAAW,EACyB,EAAE,CAAC,CAAC;IACxC,GAAI,iBAAiB,CAAC,cAAc,EAAE,SAAS,CAAkB;IACjE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAE,EAA4B,CAAC;CACvF,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC","sourcesContent":["import type { BoundQueries } from \"./bound-queries.js\";\nimport type { Container } from \"./traversal.js\";\nimport type { BoundCustomQueries, QueryMap } from \"./types.js\";\nimport { builtinQueries } from \"./queries.js\";\n\nconst bindQuery =\n    <Args extends unknown[], Result>(query: (container: Container, ...args: Args) => Result, container: Container) =>\n        (...args: Args): Result =>\n            query(container, ...args);\n\nconst bindCustomQueries = <Q extends QueryMap>(customQueries: Q, container: Container): BoundCustomQueries<Q> => {\n    const entries = Object.entries(customQueries).map(([key, query]) => [key, bindQuery(query, container)] as const);\n\n    return Object.fromEntries(entries) as BoundCustomQueries<Q>;\n};\n\n/**\n * Binds the built-in queries, and any custom queries, to a specific container\n * so they search only within that scope. Also exported as `getQueriesForElement`,\n * which reads better in library code.\n *\n * @param container The scope the returned queries operate on.\n * @param queries Optional custom queries to bind alongside the built-in ones.\n * @returns The queries bound to the container.\n */\nconst within = <Q extends QueryMap = Record<never, never>>(\n    container: Container,\n    queries?: Q,\n): BoundQueries & BoundCustomQueries<Q> => ({\n    ...(bindCustomQueries(builtinQueries, container) as BoundQueries),\n    ...(queries ? bindCustomQueries(queries, container) : ({} as BoundCustomQueries<Q>)),\n});\n\nexport { within, within as getQueriesForElement };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/testing",
-  "version": "1.0.0-rc.4",
+  "version": "1.1.0",
   "description": "Testing Library-style queries, user events, and screenshots for GTK4 widget trees rendered by GTKX",
   "keywords": [
     "gtkx",
@@ -30,6 +30,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
     }
   },
   "sideEffects": [
@@ -40,13 +44,25 @@
     "dist",
     "src"
   ],
+  "nx": {
+    "targets": {
+      "lint": {
+        "options": {
+          "cwd": ".",
+          "command": "eslint {projectRoot}"
+        }
+      }
+    }
+  },
   "engines": {
     "node": ">=24"
   },
   "dependencies": {
-    "@gtkx/react": "1.0.0-rc.4",
-    "@gtkx/runtime": "1.0.0-rc.4",
-    "@gtkx/utils": "1.0.0-rc.4"
+    "@vitest/expect": "^4.1.10",
+    "@vitest/pretty-format": "^4.1.10",
+    "@gtkx/runtime": "1.1.0",
+    "@gtkx/react": "1.1.0",
+    "@gtkx/utils": "1.1.0"
   },
   "peerDependencies": {
     "@types/react": "^19.2",
@@ -54,10 +70,7 @@
   },
   "devDependencies": {
     "@types/react": "^19.2.18",
-    "@vitest/expect": "^4.1.10",
-    "vitest": "^4.1.10",
-    "@gtkx/vitest": "1.0.0-rc.4",
-    "@gtkx/config": "1.0.0-rc.4"
+    "@gtkx/config": "1.1.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/accessible-native.ts

@@ -0,0 +1,333 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import { getHandle, t } from "@gtkx/runtime";
+
+type CheckInt = (handle: unknown, attribute: number, expected: number) => string | null;
+type CheckString = (handle: unknown, attribute: number, expected: string | null) => string | null;
+type CheckDouble = (handle: unknown, attribute: number, expected: number) => string | null;
+type CheckRelation = (...args: unknown[]) => string | null;
+/** A value GTK holds for an accessible property: a string, a number, a token, or a boolean. */
+type AccessibleAttributeValue = boolean | number | string;
+type PropertyReader = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty) => AccessibleAttributeValue | null;
+type NativeCall = (...inputs: unknown[]) => unknown;
+type CheckArg = typeof DOUBLE_ARG | typeof INT_ARG | typeof OBJECT_ARG | typeof STRING_ARG;
+
+const LIB = "libgtk-4.so.1";
+const MAX_RELATION_TARGETS = 8;
+const relationBindings: Map<number, CheckRelation> = new Map();
+
+const REVERSE_RELATIONS: Partial<Record<Gtk.AccessibleRelation, Gtk.AccessibleRelation>> = {
+    [Gtk.AccessibleRelation.LABELLED_BY]: Gtk.AccessibleRelation.LABEL_FOR,
+    [Gtk.AccessibleRelation.DESCRIBED_BY]: Gtk.AccessibleRelation.DESCRIPTION_FOR,
+    [Gtk.AccessibleRelation.ERROR_MESSAGE]: Gtk.AccessibleRelation.ERROR_MESSAGE_FOR,
+    [Gtk.AccessibleRelation.CONTROLS]: Gtk.AccessibleRelation.CONTROLLED_BY,
+    [Gtk.AccessibleRelation.DETAILS]: Gtk.AccessibleRelation.DETAILS_FOR,
+    [Gtk.AccessibleRelation.FLOW_TO]: Gtk.AccessibleRelation.FLOW_FROM,
+};
+
+const UNDEFINED_VALUE = -1;
+const INT_SENTINEL = -2_147_483_648;
+const NUMBER_SENTINEL = -Number.MAX_VALUE;
+const ACCESSIBLE_NUMBER_TOLERANCE = 0.001;
+const BOOLEAN_DOMAIN = [0, 1];
+const OPTIONAL_BOOLEAN_DOMAIN = [0, 1, UNDEFINED_VALUE];
+const TRISTATE_DOMAIN = [Gtk.AccessibleTristate.FALSE, Gtk.AccessibleTristate.TRUE, Gtk.AccessibleTristate.MIXED];
+
+const INVALID_DOMAIN = [
+    Gtk.AccessibleInvalidState.FALSE,
+    Gtk.AccessibleInvalidState.TRUE,
+    Gtk.AccessibleInvalidState.GRAMMAR,
+    Gtk.AccessibleInvalidState.SPELLING,
+];
+
+const STATE_DOMAINS: Partial<Record<Gtk.AccessibleState, number[]>> = {
+    [Gtk.AccessibleState.BUSY]: BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.CHECKED]: TRISTATE_DOMAIN,
+    [Gtk.AccessibleState.DISABLED]: BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.EXPANDED]: OPTIONAL_BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.HIDDEN]: BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.INVALID]: INVALID_DOMAIN,
+    [Gtk.AccessibleState.PRESSED]: TRISTATE_DOMAIN,
+    [Gtk.AccessibleState.SELECTED]: OPTIONAL_BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.VISITED]: OPTIONAL_BOOLEAN_DOMAIN,
+};
+
+const AUTOCOMPLETE_DOMAIN = [
+    Gtk.AccessibleAutocomplete.NONE,
+    Gtk.AccessibleAutocomplete.INLINE,
+    Gtk.AccessibleAutocomplete.LIST,
+    Gtk.AccessibleAutocomplete.BOTH,
+];
+
+const ORIENTATION_DOMAIN = [Gtk.Orientation.HORIZONTAL, Gtk.Orientation.VERTICAL];
+
+const SORT_DOMAIN = [
+    Gtk.AccessibleSort.NONE,
+    Gtk.AccessibleSort.ASCENDING,
+    Gtk.AccessibleSort.DESCENDING,
+    Gtk.AccessibleSort.OTHER,
+];
+
+const TOKEN_DOMAINS: Partial<Record<Gtk.AccessibleProperty, number[]>> = {
+    [Gtk.AccessibleProperty.AUTOCOMPLETE]: AUTOCOMPLETE_DOMAIN,
+    [Gtk.AccessibleProperty.ORIENTATION]: ORIENTATION_DOMAIN,
+    [Gtk.AccessibleProperty.SORT]: SORT_DOMAIN,
+};
+
+const STRING_PROPERTIES: Set<Gtk.AccessibleProperty> = new Set<Gtk.AccessibleProperty>([
+    Gtk.AccessibleProperty.DESCRIPTION,
+    Gtk.AccessibleProperty.HELP_TEXT,
+    Gtk.AccessibleProperty.KEY_SHORTCUTS,
+    Gtk.AccessibleProperty.LABEL,
+    Gtk.AccessibleProperty.PLACEHOLDER,
+    Gtk.AccessibleProperty.ROLE_DESCRIPTION,
+    Gtk.AccessibleProperty.VALUE_TEXT,
+]);
+
+const BOOLEAN_PROPERTIES: Set<Gtk.AccessibleProperty> = new Set<Gtk.AccessibleProperty>([
+    Gtk.AccessibleProperty.HAS_POPUP,
+    Gtk.AccessibleProperty.MODAL,
+    Gtk.AccessibleProperty.MULTI_LINE,
+    Gtk.AccessibleProperty.MULTI_SELECTABLE,
+    Gtk.AccessibleProperty.READ_ONLY,
+    Gtk.AccessibleProperty.REQUIRED,
+]);
+
+const NUMBER_PROPERTIES: Set<Gtk.AccessibleProperty> = new Set<Gtk.AccessibleProperty>([
+    Gtk.AccessibleProperty.VALUE_MAX,
+    Gtk.AccessibleProperty.VALUE_MIN,
+    Gtk.AccessibleProperty.VALUE_NOW,
+]);
+
+const OBJECT_ARG = { type: t.object("borrowed") };
+const INT_ARG = { type: t.int32 };
+const DOUBLE_ARG = { type: t.float64 };
+const STRING_ARG = { type: t.string("borrowed") };
+const CHECK_PROPERTY = "gtk_test_accessible_check_property";
+const checkStateInt = buildAccessibleCheck("gtk_test_accessible_check_state", [INT_ARG]) as CheckInt;
+const checkPropertyInt = buildAccessibleCheck(CHECK_PROPERTY, [INT_ARG]) as CheckInt;
+const checkPropertyDouble = buildAccessibleCheck(CHECK_PROPERTY, [DOUBLE_ARG]) as CheckDouble;
+const checkPropertyString = buildAccessibleCheck(CHECK_PROPERTY, [STRING_ARG]) as CheckString;
+
+function buildAccessibleCheck(symbol: string, varargs: CheckArg[]): NativeCall {
+    return t.fn(LIB, symbol, {
+        args: [OBJECT_ARG, INT_ARG, ...varargs],
+        returns: t.string("full"),
+        fixedArgCount: 2,
+    });
+}
+
+const buildRelationBinding = (targetCount: number): CheckRelation => {
+    const targets = Array.from({ length: targetCount + 1 }, () => OBJECT_ARG);
+
+    return buildAccessibleCheck("gtk_test_accessible_check_relation", targets) as CheckRelation;
+};
+
+const relationBindingFor = (targetCount: number): CheckRelation => {
+    const cached = relationBindings.get(targetCount);
+
+    if (cached !== undefined) {
+        return cached;
+    }
+
+    const built = buildRelationBinding(targetCount);
+    relationBindings.set(targetCount, built);
+
+    return built;
+};
+
+const isRelationExactly = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    candidate: Gtk.Accessible,
+    targetCount: number,
+): boolean => {
+    const call = relationBindingFor(targetCount);
+    const repeated = Array.from({ length: targetCount }, () => getHandle(candidate));
+
+    return call(getHandle(accessible), relation, ...repeated, null) === null;
+};
+
+const hasRelationSize = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    candidates: Gtk.Accessible[],
+    size: number,
+): boolean => candidates.some((candidate) => isRelationExactly(accessible, relation, candidate, size));
+
+const findRelationSize = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    candidates: Gtk.Accessible[],
+): number => {
+    for (let size = 1; size <= MAX_RELATION_TARGETS; size += 1) {
+        if (hasRelationSize(accessible, relation, candidates, size)) {
+            return size;
+        }
+    }
+
+    return 0;
+};
+
+const possibleTargets = (relation: Gtk.AccessibleRelation, candidates: Gtk.Accessible[]): Gtk.Accessible[] => {
+    const reverse = REVERSE_RELATIONS[relation];
+
+    if (reverse === undefined) {
+        return candidates;
+    }
+
+    return candidates.filter((candidate) => Gtk.testAccessibleHasRelation(candidate, reverse));
+};
+
+const readAccessibleRelation = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    pool: Gtk.Accessible[],
+): Gtk.Accessible[] => {
+    if (!Gtk.testAccessibleHasRelation(accessible, relation)) {
+        return [];
+    }
+
+    const candidates = possibleTargets(relation, pool);
+    const size = findRelationSize(accessible, relation, candidates);
+
+    if (size === 0) {
+        return [];
+    }
+
+    return candidates.filter((candidate) => isRelationExactly(accessible, relation, candidate, size));
+};
+
+const memberOfDomain = (check: CheckInt, handle: unknown, attribute: number, domain: number[]): number | null => {
+    for (const candidate of domain) {
+        if (check(handle, attribute, candidate) === null) {
+            return candidate;
+        }
+    }
+
+    return null;
+};
+
+const readAccessibleState = (accessible: Gtk.Accessible, state: Gtk.AccessibleState): number | null => {
+    const domain = STATE_DOMAINS[state];
+
+    if (domain === undefined || !Gtk.testAccessibleHasState(accessible, state)) {
+        return null;
+    }
+
+    const member = memberOfDomain(checkStateInt, getHandle(accessible), state, domain);
+
+    return member === UNDEFINED_VALUE ? null : member;
+};
+
+const readAccessibleFlag = (accessible: Gtk.Accessible, state: Gtk.AccessibleState): boolean | null => {
+    const value = readAccessibleState(accessible, state);
+
+    return value === null ? null : value === 1;
+};
+
+const readAccessibleString = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty): string | null => {
+    if (!Gtk.testAccessibleHasProperty(accessible, property)) {
+        return null;
+    }
+
+    return checkPropertyString(getHandle(accessible), property, null);
+};
+
+const readAccessibleToken = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+    domain: number[],
+): number | null => {
+    if (!Gtk.testAccessibleHasProperty(accessible, property)) {
+        return null;
+    }
+
+    return memberOfDomain(checkPropertyInt, getHandle(accessible), property, domain);
+};
+
+const readAccessibleBooleanProperty = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+): boolean | null => {
+    const member = readAccessibleToken(accessible, property, BOOLEAN_DOMAIN);
+
+    return member === null ? null : member === 1;
+};
+
+const readAgainstSentinel = (
+    check: CheckDouble,
+    sentinel: number,
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+): number | null => {
+    if (!Gtk.testAccessibleHasProperty(accessible, property)) {
+        return null;
+    }
+
+    const reported = check(getHandle(accessible), property, sentinel);
+
+    return reported === null ? sentinel : Number(reported);
+};
+
+const readAccessibleInt = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty): number | null =>
+    readAgainstSentinel(checkPropertyInt, INT_SENTINEL, accessible, property);
+
+const readAccessibleNumber = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty): number | null =>
+    readAgainstSentinel(checkPropertyDouble, NUMBER_SENTINEL, accessible, property);
+
+const isAccessibleNumberProperty = (property: Gtk.AccessibleProperty): boolean => NUMBER_PROPERTIES.has(property);
+
+const isAccessibleNumberMatch = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+    expected: number,
+): boolean =>
+    Gtk.testAccessibleHasProperty(accessible, property) &&
+    checkPropertyDouble(getHandle(accessible), property, expected) === null;
+
+const tokenReaderFor =
+    (domain: number[]): PropertyReader =>
+        (accessible, property) =>
+            readAccessibleToken(accessible, property, domain);
+
+const propertyReaderFor = (property: Gtk.AccessibleProperty): PropertyReader => {
+    const domain = TOKEN_DOMAINS[property];
+
+    if (domain !== undefined) {
+        return tokenReaderFor(domain);
+    }
+
+    if (STRING_PROPERTIES.has(property)) {
+        return readAccessibleString;
+    }
+
+    if (BOOLEAN_PROPERTIES.has(property)) {
+        return readAccessibleBooleanProperty;
+    }
+
+    if (NUMBER_PROPERTIES.has(property)) {
+        return readAccessibleNumber;
+    }
+
+    return readAccessibleInt;
+};
+
+const readAccessibleProperty = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+): AccessibleAttributeValue | null => propertyReaderFor(property)(accessible, property);
+
+export {
+    ACCESSIBLE_NUMBER_TOLERANCE,
+    isAccessibleNumberMatch,
+    isAccessibleNumberProperty,
+    readAccessibleBooleanProperty,
+    readAccessibleFlag,
+    readAccessibleInt,
+    readAccessibleNumber,
+    readAccessibleProperty,
+    readAccessibleRelation,
+    readAccessibleState,
+    readAccessibleString,
+    type AccessibleAttributeValue,
+};

package/src/act.ts

@@ -76,4 +76,4 @@ const runInAct = async (callback: () => unknown): Promise<void> => {
     await act(() => callback());
 };
 
-export { act, getIsReactActEnvironment, setIsReactActEnvironment, runWithActEnvironment, runInAct };
+export { act, runWithActEnvironment, runInAct };