@gtkx/testing 1.0.0-rc.4 → 1.0.0

package/src/widget-getters.ts

@@ -0,0 +1,32 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+import { getInstanceType, typeName } from "@gtkx/runtime";
+
+const getWidgetMethod = (widget: Gtk.Widget, name: string): unknown => Reflect.get(widget, name);
+const getWidgetTypeName = (widget: Gtk.Widget): string | null => typeName(getInstanceType(widget));
+
+const hasWidgetMethod = (widget: Gtk.Widget, name: string): boolean =>
+    typeof getWidgetMethod(widget, name) === "function";
+
+/* eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- callers name the signature */
+const getCallableMethod = <Args extends unknown[], Result>(
+    widget: Gtk.Widget,
+    name: string,
+): ((...args: Args) => Result) | null => {
+    const fn = getWidgetMethod(widget, name);
+
+    return typeof fn === "function" ? (fn as (...args: Args) => Result).bind(widget) : null;
+};
+
+const callBooleanGetter = (widget: Gtk.Widget, method: string): boolean | null => {
+    const value = getCallableMethod<[], unknown>(widget, method)?.();
+
+    return typeof value === "boolean" ? value : null;
+};
+
+const callStringGetter = (widget: Gtk.Widget, method: string): string | null => {
+    const value = getCallableMethod<[], unknown>(widget, method)?.();
+
+    return typeof value === "string" ? value : null;
+};
+
+export { callBooleanGetter, callStringGetter, getCallableMethod, getWidgetTypeName, hasWidgetMethod };

package/src/within.ts

@@ -16,7 +16,8 @@ const bindCustomQueries = <Q extends QueryMap>(customQueries: Q, container: Cont
 
 /**
  * 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.
@@ -30,4 +31,4 @@ const within = <Q extends QueryMap = Record<never, never>>(
     ...(queries ? bindCustomQueries(queries, container) : ({} as BoundCustomQueries<Q>)),
 });
 
-export { within };
+export { within, within as getQueriesForElement };