@gtkx/testing 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/types.d.ts

@@ -3,21 +3,29 @@ import type { RootElement } from "@gtkx/react";
 import type { ComponentType, ErrorInfo, ReactNode } from "react";
 import type { PrettyWidgetOptions } from "./pretty-widget.js";
 import type { Container } from "./traversal.js";
-/** A custom matcher predicate: given a candidate widget's normalized text content and the widget itself, returns whether it matches. */
-export type MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;
+/**
+ * A custom matcher predicate: given a candidate widget's normalized text content and the widget
+ * itself, returns whether it matches.
+ */
+type MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;
 /** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */
-export type Matcher = string | number | RegExp | MatcherFunction;
+type Matcher = string | number | RegExp | MatcherFunction;
 /** Normalizes a widget's text before it is compared against a matcher. */
-export type NormalizerFn = (text: string) => string;
+type NormalizerFn = (text: string) => string;
+/**
+ * A widget class usable as a query's `as` constraint, such as `Gtk.Button`. Abstract classes and
+ * generated GInterface pseudo-classes are accepted.
+ */
+type WidgetType<T extends Gtk.Widget = Gtk.Widget> = abstract new (...args: never[]) => T;
 /** Options controlling the default text normalizer. */
-export type NormalizerOptions = {
+type NormalizerOptions = {
     /** Trim leading and trailing whitespace. */
     trim?: boolean | undefined;
     /** Collapse runs of whitespace into a single space. */
     collapseWhitespace?: boolean | undefined;
 };
 /** Options controlling how asynchronous queries and waits poll for a condition. */
-export type WaitForOptions = {
+type WaitForOptions = {
     /** Maximum time in milliseconds to keep retrying before failing. */
     timeout?: number | undefined;
     /** Delay in milliseconds between retries. */
@@ -28,7 +36,7 @@ export type WaitForOptions = {
     stackTraceError?: Error | undefined;
 };
 /** Options controlling text matching and, for asynchronous queries, polling behavior. */
-export type MatcherOptions = {
+type MatcherOptions<T extends Gtk.Widget = Gtk.Widget> = {
     /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */
     exact?: boolean | undefined;
     /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */
@@ -39,9 +47,11 @@ export type MatcherOptions = {
     collapseWhitespace?: boolean | undefined;
     /** Whether to include a suggested better query in error messages. */
     suggest?: boolean | undefined;
+    /** Restricts matches to instances of this widget class, and narrows the query's return type to it. */
+    as?: WidgetType<T> | undefined;
 } & WaitForOptions;
 /** Constraints on a widget's numeric range value used by role queries. */
-export type ByRoleValue = {
+type ByRoleValue = {
     /** The current value. */
     now?: number | undefined;
     min?: number | undefined;
@@ -50,7 +60,7 @@ export type ByRoleValue = {
     text?: Matcher | undefined;
 };
 /** Options for role queries: an accessible name matcher plus accessible state and value constraints. */
-export type ByRoleOptions = MatcherOptions & {
+type ByRoleOptions<T extends Gtk.Widget = Gtk.Widget> = MatcherOptions<T> & {
     name?: Matcher | undefined;
     checked?: boolean | undefined;
     pressed?: boolean | undefined;
@@ -65,17 +75,39 @@ export type ByRoleOptions = MatcherOptions & {
     hidden?: boolean | undefined;
 };
 /** A React component that wraps rendered content, receiving it as its children. */
-export type WrapperComponent = ComponentType<{
+type WrapperComponent = ComponentType<{
     children: ReactNode;
 }>;
 type Query = (container: Container, ...args: never[]) => unknown;
-export type QueryMap = Record<string, Query>;
+type QueryMap = Record<string, Query>;
 type BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R ? (...args: A) => R : never;
-export type BoundCustomQueries<Q extends QueryMap> = {
+type BoundCustomQueries<Q extends QueryMap> = {
     [K in keyof Q]: BoundQuery<Q[K]>;
 };
-/** Options for {@link render}: the container and base element to mount into, an optional wrapper, React behavior toggles, error callbacks, and custom queries to bind. */
-export type RenderOptions<Q extends QueryMap = Record<never, never>> = {
+type QueryFamilyReturns<T extends Gtk.Widget> = {
+    queryBy: T | null;
+    queryAllBy: T[];
+    getBy: T;
+    getAllBy: T[];
+    findBy: Promise<T>;
+    findAllBy: Promise<T[]>;
+};
+type QueryKind = "role" | "text" | "name" | "value";
+type QueryArgs<Kind extends QueryKind, T extends Gtk.Widget> = Kind extends "role" ? [role: Gtk.AccessibleRole, options?: ByRoleOptions<T>] : Kind extends "name" ? [name: Matcher, options?: MatcherOptions<T>] : Kind extends "value" ? [value: Matcher, options?: MatcherOptions<T>] : [text: Matcher, options?: MatcherOptions<T>];
+/**
+ * One query family (`queryBy`, `getBy`, `findBy` and their `All` variants) for a single suffix.
+ * Each member takes an explicit widget type, as Testing Library's queries do, and also infers it
+ * from an `as` option.
+ */
+type QueryFamily<Suffix extends string, Kind extends QueryKind, Head extends unknown[]> = {
+    [K in keyof QueryFamilyReturns<Gtk.Widget> as `${K & string}${Suffix}`]: <T extends Gtk.Widget = Gtk.Widget>(...args: [...Head, ...QueryArgs<Kind, T>]) => QueryFamilyReturns<T>[K];
+};
+type QueryFamilies<Head extends unknown[]> = QueryFamily<"Role", "role", Head> & QueryFamily<"LabelText", "text", Head> & QueryFamily<"Text", "text", Head> & QueryFamily<"Name", "name", Head> & QueryFamily<"PlaceholderText", "text", Head> & QueryFamily<"DisplayValue", "value", Head>;
+/**
+ * Options for {@link render}: the container and base element to mount into, an optional wrapper,
+ * React behavior toggles, error callbacks, and custom queries to bind.
+ */
+type RenderOptions<Q extends QueryMap = Record<never, never>> = {
     container?: Gtk.Widget | RootElement | undefined;
     /** Root of the subtree that bound queries search. */
     baseElement?: Container | undefined;
@@ -91,35 +123,44 @@ export type RenderOptions<Q extends QueryMap = Record<never, never>> = {
     /** Custom queries to bind to the rendered result. */
     queries?: Q | undefined;
 };
-export type DebugUtilities = {
+type DebugUtilities = {
     debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;
     logRoles: () => void;
     screenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
 };
 /** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */
-export type ScreenshotResult = {
+type ScreenshotResult = {
     data: string;
     mimeType: string;
     width: number;
     height: number;
 };
 /** Options for capturing a screenshot: the poll timeout and interval, plus a rendering scale factor. */
-export type ScreenshotOptions = Pick<WaitForOptions, "timeout" | "interval"> & {
+type ScreenshotOptions = Pick<WaitForOptions, "timeout" | "interval"> & {
     /** Device scale factor applied when rendering. */
     scale?: number;
 };
-/** Selects the window to screenshot by index, or by title (exact string or regular expression); undefined targets the default window. */
-export type WindowSelector = number | string | RegExp | undefined;
-/** Options for {@link renderHook}: an optional wrapper and the initial props (required unless the props type permits undefined). */
-export type RenderHookOptions<Props> = {
+/**
+ * Selects the window to screenshot by index, or by title (exact string or regular expression);
+ * undefined targets the default window.
+ */
+type WindowSelector = number | string | RegExp | undefined;
+/**
+ * Options for {@link renderHook}: an optional wrapper and the initial props (required unless the
+ * props type permits undefined).
+ */
+type RenderHookOptions<Props> = {
     wrapper?: WrapperComponent;
 } & (undefined extends Props ? {
     initialProps?: Props;
 } : {
     initialProps: Props;
 });
-/** The result of {@link renderHook}: the latest hook return value plus functions to rerender with new props and to unmount. */
-export type RenderHookResult<Result, Props> = {
+/**
+ * The result of {@link renderHook}: the latest hook return value plus functions to rerender with new
+ * props and to unmount.
+ */
+type RenderHookResult<Result, Props> = {
     /** Holds the most recent value returned by the hook under `current`. */
     result: {
         current: Result;
@@ -127,5 +168,5 @@ export type RenderHookResult<Result, Props> = {
     rerender: (newProps?: Props) => Promise<void>;
     unmount: () => Promise<void>;
 };
-export {};
+export { type MatcherFunction, type Matcher, type NormalizerFn, type NormalizerOptions, type WaitForOptions, type MatcherOptions, type ByRoleValue, type ByRoleOptions, type WidgetType, type WrapperComponent, type QueryMap, type BoundCustomQueries, type QueryFamilies, type RenderOptions, type DebugUtilities, type ScreenshotResult, type ScreenshotOptions, type WindowSelector, type RenderHookOptions, type RenderHookResult, };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,wIAAwI;AACxI,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC;AAE/E,wHAAwH;AACxH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;AAEjE,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG;IACzB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,GAAG,SAAS,CAAC;IAClD,kFAAkF;IAClF,eAAe,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG;IACzB,4GAA4G;IAC5G,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,uGAAuG;IACvG,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,GAAG,cAAc,CAAC;AAEnB,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG;IACtB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF,wGAAwG;AACxG,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IACzC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;IACzC,QAAQ,EAAE,SAAS,CAAC;CACvB,CAAC,CAAC;AAEH,KAAK,KAAK,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE7C,KAAK,UAAU,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAC1F,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GACjB,KAAK,CAAC;AAEZ,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,QAAQ,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE1F,0KAA0K;AAC1K,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI;IACnE,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACjD,qDAAqD;IACrD,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7E,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClF,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClF,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACrG,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wGAAwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IAC3E,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,yIAAyI;AACzI,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,oIAAoI;AACpI,MAAM,MAAM,iBAAiB,CAAC,KAAK,IAAI;IACnC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC9B,GAAG,CAAC,SAAS,SAAS,KAAK,GACtB;IACI,YAAY,CAAC,EAAE,KAAK,CAAC;CACxB,GACD;IACI,YAAY,EAAE,KAAK,CAAC;CACvB,CAAC,CAAC;AAET,+HAA+H;AAC/H,MAAM,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,IAAI;IAC1C,wEAAwE;IACxE,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RootElement } from \"@gtkx/react\";\nimport type { ComponentType, ErrorInfo, ReactNode } from \"react\";\nimport type { PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport type { Container } from \"./traversal.js\";\n\n/** A custom matcher predicate: given a candidate widget's normalized text content and the widget itself, returns whether it matches. */\nexport type MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;\n\n/** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */\nexport type Matcher = string | number | RegExp | MatcherFunction;\n\n/** Normalizes a widget's text before it is compared against a matcher. */\nexport type NormalizerFn = (text: string) => string;\n\n/** Options controlling the default text normalizer. */\nexport type NormalizerOptions = {\n    /** Trim leading and trailing whitespace. */\n    trim?: boolean | undefined;\n    /** Collapse runs of whitespace into a single space. */\n    collapseWhitespace?: boolean | undefined;\n};\n\n/** Options controlling how asynchronous queries and waits poll for a condition. */\nexport type WaitForOptions = {\n    /** Maximum time in milliseconds to keep retrying before failing. */\n    timeout?: number | undefined;\n    /** Delay in milliseconds between retries. */\n    interval?: number | undefined;\n    /** Transforms the error thrown when the timeout elapses. */\n    onTimeout?: ((error: Error) => Error) | undefined;\n    /** Error whose stack trace attributes the timeout failure to the calling code. */\n    stackTraceError?: Error | undefined;\n};\n\n/** Options controlling text matching and, for asynchronous queries, polling behavior. */\nexport type MatcherOptions = {\n    /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */\n    exact?: boolean | undefined;\n    /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */\n    normalizer?: NormalizerFn | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    trim?: boolean | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    collapseWhitespace?: boolean | undefined;\n    /** Whether to include a suggested better query in error messages. */\n    suggest?: boolean | undefined;\n} & WaitForOptions;\n\n/** Constraints on a widget's numeric range value used by role queries. */\nexport type ByRoleValue = {\n    /** The current value. */\n    now?: number | undefined;\n    min?: number | undefined;\n    max?: number | undefined;\n    /** Matcher for the value's textual representation. */\n    text?: Matcher | undefined;\n};\n\n/** Options for role queries: an accessible name matcher plus accessible state and value constraints. */\nexport type ByRoleOptions = MatcherOptions & {\n    name?: Matcher | undefined;\n    checked?: boolean | undefined;\n    pressed?: boolean | undefined;\n    selected?: boolean | undefined;\n    expanded?: boolean | undefined;\n    /** Heading or hierarchy level. */\n    level?: number | undefined;\n    busy?: boolean | undefined;\n    description?: Matcher | undefined;\n    value?: ByRoleValue | undefined;\n    /** When true, include widgets excluded from the accessibility tree. */\n    hidden?: boolean | undefined;\n};\n\n/** A React component that wraps rendered content, receiving it as its children. */\nexport type WrapperComponent = ComponentType<{\n    children: ReactNode;\n}>;\n\ntype Query = (container: Container, ...args: never[]) => unknown;\n\nexport type QueryMap = Record<string, Query>;\n\ntype BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R\n    ? (...args: A) => R\n    : never;\n\nexport type BoundCustomQueries<Q extends QueryMap> = { [K in keyof Q]: BoundQuery<Q[K]> };\n\n/** Options for {@link render}: the container and base element to mount into, an optional wrapper, React behavior toggles, error callbacks, and custom queries to bind. */\nexport type RenderOptions<Q extends QueryMap = Record<never, never>> = {\n    container?: Gtk.Widget | RootElement | undefined;\n    /** Root of the subtree that bound queries search. */\n    baseElement?: Container | undefined;\n    wrapper?: WrapperComponent | undefined;\n    /** Render inside React StrictMode. */\n    reactStrictMode?: boolean | undefined;\n    /** Enable widget animations during the test. */\n    animations?: boolean | undefined;\n    /** Called for errors caught by React error boundaries. */\n    onCaughtError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Called for errors React recovered from automatically. */\n    onRecoverableError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Custom queries to bind to the rendered result. */\n    queries?: Q | undefined;\n};\n\nexport type DebugUtilities = {\n    debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;\n    logRoles: () => void;\n    screenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;\n};\n\n/** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */\nexport type ScreenshotResult = {\n    data: string;\n    mimeType: string;\n    width: number;\n    height: number;\n};\n\n/** Options for capturing a screenshot: the poll timeout and interval, plus a rendering scale factor. */\nexport type ScreenshotOptions = Pick<WaitForOptions, \"timeout\" | \"interval\"> & {\n    /** Device scale factor applied when rendering. */\n    scale?: number;\n};\n\n/** Selects the window to screenshot by index, or by title (exact string or regular expression); undefined targets the default window. */\nexport type WindowSelector = number | string | RegExp | undefined;\n\n/** Options for {@link renderHook}: an optional wrapper and the initial props (required unless the props type permits undefined). */\nexport type RenderHookOptions<Props> = {\n    wrapper?: WrapperComponent;\n} & (undefined extends Props\n    ? {\n          initialProps?: Props;\n      }\n    : {\n          initialProps: Props;\n      });\n\n/** The result of {@link renderHook}: the latest hook return value plus functions to rerender with new props and to unmount. */\nexport type RenderHookResult<Result, Props> = {\n    /** Holds the most recent value returned by the hook under `current`. */\n    result: { current: Result };\n    rerender: (newProps?: Props) => Promise<void>;\n    unmount: () => Promise<void>;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8MA,OAAO,EAqBN,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RootElement } from \"@gtkx/react\";\nimport type { ComponentType, ErrorInfo, ReactNode } from \"react\";\nimport type { PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport type { Container } from \"./traversal.js\";\n\n/**\n * A custom matcher predicate: given a candidate widget's normalized text content and the widget\n * itself, returns whether it matches.\n */\ntype MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;\n/** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */\ntype Matcher = string | number | RegExp | MatcherFunction;\n/** Normalizes a widget's text before it is compared against a matcher. */\ntype NormalizerFn = (text: string) => string;\n/**\n * A widget class usable as a query's `as` constraint, such as `Gtk.Button`. Abstract classes and\n * generated GInterface pseudo-classes are accepted.\n */\ntype WidgetType<T extends Gtk.Widget = Gtk.Widget> = abstract new (...args: never[]) => T;\n\n/** Options controlling the default text normalizer. */\ntype NormalizerOptions = {\n    /** Trim leading and trailing whitespace. */\n    trim?: boolean | undefined;\n    /** Collapse runs of whitespace into a single space. */\n    collapseWhitespace?: boolean | undefined;\n};\n\n/** Options controlling how asynchronous queries and waits poll for a condition. */\ntype WaitForOptions = {\n    /** Maximum time in milliseconds to keep retrying before failing. */\n    timeout?: number | undefined;\n    /** Delay in milliseconds between retries. */\n    interval?: number | undefined;\n    /** Transforms the error thrown when the timeout elapses. */\n    onTimeout?: ((error: Error) => Error) | undefined;\n    /** Error whose stack trace attributes the timeout failure to the calling code. */\n    stackTraceError?: Error | undefined;\n};\n\n/** Options controlling text matching and, for asynchronous queries, polling behavior. */\ntype MatcherOptions<T extends Gtk.Widget = Gtk.Widget> = {\n    /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */\n    exact?: boolean | undefined;\n    /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */\n    normalizer?: NormalizerFn | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    trim?: boolean | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    collapseWhitespace?: boolean | undefined;\n    /** Whether to include a suggested better query in error messages. */\n    suggest?: boolean | undefined;\n    /** Restricts matches to instances of this widget class, and narrows the query's return type to it. */\n    as?: WidgetType<T> | undefined;\n} & WaitForOptions;\n\n/** Constraints on a widget's numeric range value used by role queries. */\ntype ByRoleValue = {\n    /** The current value. */\n    now?: number | undefined;\n    min?: number | undefined;\n    max?: number | undefined;\n    /** Matcher for the value's textual representation. */\n    text?: Matcher | undefined;\n};\n\n/** Options for role queries: an accessible name matcher plus accessible state and value constraints. */\ntype ByRoleOptions<T extends Gtk.Widget = Gtk.Widget> = MatcherOptions<T> & {\n    name?: Matcher | undefined;\n    checked?: boolean | undefined;\n    pressed?: boolean | undefined;\n    selected?: boolean | undefined;\n    expanded?: boolean | undefined;\n    /** Heading or hierarchy level. */\n    level?: number | undefined;\n    busy?: boolean | undefined;\n    description?: Matcher | undefined;\n    value?: ByRoleValue | undefined;\n    /** When true, include widgets excluded from the accessibility tree. */\n    hidden?: boolean | undefined;\n};\n\n/** A React component that wraps rendered content, receiving it as its children. */\ntype WrapperComponent = ComponentType<{\n    children: ReactNode;\n}>;\n\ntype Query = (container: Container, ...args: never[]) => unknown;\ntype QueryMap = Record<string, Query>;\n\ntype BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R\n    ? (...args: A) => R\n    : never;\n\ntype BoundCustomQueries<Q extends QueryMap> = { [K in keyof Q]: BoundQuery<Q[K]> };\n\ntype QueryFamilyReturns<T extends Gtk.Widget> = {\n    queryBy: T | null;\n    queryAllBy: T[];\n    getBy: T;\n    getAllBy: T[];\n    findBy: Promise<T>;\n    findAllBy: Promise<T[]>;\n};\n\ntype QueryKind = \"role\" | \"text\" | \"name\" | \"value\";\n\ntype QueryArgs<Kind extends QueryKind, T extends Gtk.Widget> = Kind extends \"role\"\n    ? [role: Gtk.AccessibleRole, options?: ByRoleOptions<T>]\n    : Kind extends \"name\"\n        ? [name: Matcher, options?: MatcherOptions<T>]\n        : Kind extends \"value\"\n            ? [value: Matcher, options?: MatcherOptions<T>]\n            : [text: Matcher, options?: MatcherOptions<T>];\n\n/**\n * One query family (`queryBy`, `getBy`, `findBy` and their `All` variants) for a single suffix.\n * Each member takes an explicit widget type, as Testing Library's queries do, and also infers it\n * from an `as` option.\n */\ntype QueryFamily<Suffix extends string, Kind extends QueryKind, Head extends unknown[]> = {\n    [K in keyof QueryFamilyReturns<Gtk.Widget> as `${K & string}${Suffix}`]: <T extends Gtk.Widget = Gtk.Widget>(\n        ...args: [...Head, ...QueryArgs<Kind, T>]\n    ) => QueryFamilyReturns<T>[K];\n};\n\ntype QueryFamilies<Head extends unknown[]> = QueryFamily<\"Role\", \"role\", Head> &\n    QueryFamily<\"LabelText\", \"text\", Head> &\n    QueryFamily<\"Text\", \"text\", Head> &\n    QueryFamily<\"Name\", \"name\", Head> &\n    QueryFamily<\"PlaceholderText\", \"text\", Head> &\n    QueryFamily<\"DisplayValue\", \"value\", Head>;\n\n/**\n * Options for {@link render}: the container and base element to mount into, an optional wrapper,\n * React behavior toggles, error callbacks, and custom queries to bind.\n */\ntype RenderOptions<Q extends QueryMap = Record<never, never>> = {\n    container?: Gtk.Widget | RootElement | undefined;\n    /** Root of the subtree that bound queries search. */\n    baseElement?: Container | undefined;\n    wrapper?: WrapperComponent | undefined;\n    /** Render inside React StrictMode. */\n    reactStrictMode?: boolean | undefined;\n    /** Enable widget animations during the test. */\n    animations?: boolean | undefined;\n    /** Called for errors caught by React error boundaries. */\n    onCaughtError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Called for errors React recovered from automatically. */\n    onRecoverableError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Custom queries to bind to the rendered result. */\n    queries?: Q | undefined;\n};\n\ntype DebugUtilities = {\n    debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;\n    logRoles: () => void;\n    screenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;\n};\n\n/** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */\ntype ScreenshotResult = {\n    data: string;\n    mimeType: string;\n    width: number;\n    height: number;\n};\n\n/** Options for capturing a screenshot: the poll timeout and interval, plus a rendering scale factor. */\ntype ScreenshotOptions = Pick<WaitForOptions, \"timeout\" | \"interval\"> & {\n    /** Device scale factor applied when rendering. */\n    scale?: number;\n};\n\n/**\n * Selects the window to screenshot by index, or by title (exact string or regular expression);\n * undefined targets the default window.\n */\ntype WindowSelector = number | string | RegExp | undefined;\n\n/**\n * Options for {@link renderHook}: an optional wrapper and the initial props (required unless the\n * props type permits undefined).\n */\ntype RenderHookOptions<Props> = {\n    wrapper?: WrapperComponent;\n} & (undefined extends Props\n    ? {\n            initialProps?: Props;\n        }\n    : {\n            initialProps: Props;\n        });\n\n/**\n * The result of {@link renderHook}: the latest hook return value plus functions to rerender with new\n * props and to unmount.\n */\ntype RenderHookResult<Result, Props> = {\n    /** Holds the most recent value returned by the hook under `current`. */\n    result: { current: Result };\n    rerender: (newProps?: Props) => Promise<void>;\n    unmount: () => Promise<void>;\n};\n\nexport {\n    type MatcherFunction,\n    type Matcher,\n    type NormalizerFn,\n    type NormalizerOptions,\n    type WaitForOptions,\n    type MatcherOptions,\n    type ByRoleValue,\n    type ByRoleOptions,\n    type WidgetType,\n    type WrapperComponent,\n    type QueryMap,\n    type BoundCustomQueries,\n    type QueryFamilies,\n    type RenderOptions,\n    type DebugUtilities,\n    type ScreenshotResult,\n    type ScreenshotOptions,\n    type WindowSelector,\n    type RenderHookOptions,\n    type RenderHookResult,\n};\n"]}

package/dist/user-event/adjustment.d.ts

@@ -1,8 +1,10 @@
 import * as Gtk from "@gtkx/gi/gtk";
-export type ScrollDelta = {
+/** A scroll distance in pixels along each axis. */
+type ScrollDelta = {
     x?: number;
     y?: number;
 };
-export declare const slide: (widget: Gtk.Widget, value: number) => Promise<void>;
-export declare const scroll: (widget: Gtk.Widget, delta: ScrollDelta) => Promise<void>;
+declare const slide: (widget: Gtk.Widget, value: number) => Promise<void>;
+declare const scroll: (widget: Gtk.Widget, delta: ScrollDelta) => Promise<void>;
+export { slide, scroll, type ScrollDelta };
 //# sourceMappingURL=adjustment.d.ts.map

package/dist/user-event/adjustment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adjustment.d.ts","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,MAAM,MAAM,WAAW,GAAG;IACtB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,KAAK,WAAY,GAAG,CAAC,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAMhE,CAAC;AAwBP,eAAO,MAAM,MAAM,WAAY,GAAG,CAAC,MAAM,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAUtE,CAAC"}
+{"version":3,"file":"adjustment.d.ts","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,mDAAmD;AACnD,KAAK,WAAW,GAAG;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CASzD,CAAC;AAwBP,QAAA,MAAM,MAAM,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,IAAI,CAY/D,CAAC;AAEP,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/user-event/adjustment.js

@@ -1,8 +1,8 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { wrapEvent } from "./event-wrapper.js";
-export const slide = (widget, value) => wrapEvent(widget, () => {
+const slide = (widget, value) => wrapEvent(widget, () => {
     if (!(widget instanceof Gtk.Range)) {
-        throw new Error(`userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`);
+        throw new TypeError(`userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`);
     }
     widget.emit("change-value", Gtk.ScrollType.JUMP, value);
 });
@@ -18,11 +18,12 @@ const resolveScrollAdjustments = (widget) => {
     return null;
 };
 const applyScrollDelta = (adjustment, delta) => {
-    if (!adjustment || delta === 0)
+    if (!adjustment || delta === 0) {
         return;
+    }
     adjustment.setValue(adjustment.getValue() + delta);
 };
-export const scroll = (widget, delta) => wrapEvent(widget, () => {
+const scroll = (widget, delta) => wrapEvent(widget, () => {
     const adjustments = resolveScrollAdjustments(widget);
     if (!adjustments) {
         throw new Error("userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors");
@@ -30,4 +31,5 @@ export const scroll = (widget, delta) => wrapEvent(widget, () => {
     applyScrollDelta(adjustments.horizontal, delta.x ?? 0);
     applyScrollDelta(adjustments.vertical, delta.y ?? 0);
 });
+export { slide, scroll };
 //# sourceMappingURL=adjustment.js.map

package/dist/user-event/adjustment.js.map

@@ -1 +1 @@
-{"version":3,"file":"adjustment.js","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO/C,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAkB,EAAE,KAAa,EAAiB,EAAE,CACtE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,8DAA8D,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAOP,MAAM,wBAAwB,GAAG,CAAC,MAAkB,EAA4B,EAAE;IAC9E,KAAK,IAAI,OAAO,GAAsB,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACnF,IAAI,OAAO,YAAY,GAAG,CAAC,cAAc,EAAE,CAAC;YACxC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACxF,CAAC;QACD,IAAI,OAAO,YAAY,GAAG,CAAC,UAAU,EAAE,CAAC;YACpC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACxF,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,UAAiC,EAAE,KAAa,EAAQ,EAAE;IAChF,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACvC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,KAAkB,EAAiB,EAAE,CAC5E,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACX,gGAAgG,CACnG,CAAC;IACN,CAAC;IACD,gBAAgB,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,gBAAgB,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\nexport type ScrollDelta = {\n    x?: number;\n    y?: number;\n};\n\nexport const slide = (widget: Gtk.Widget, value: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!(widget instanceof Gtk.Range)) {\n            throw new Error(`userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`);\n        }\n        widget.emit(\"change-value\", Gtk.ScrollType.JUMP, value);\n    });\n\ntype ScrollAdjustments = {\n    horizontal: Gtk.Adjustment | null;\n    vertical: Gtk.Adjustment | null;\n};\n\nconst resolveScrollAdjustments = (widget: Gtk.Widget): ScrollAdjustments | null => {\n    for (let current: Gtk.Widget | null = widget; current; current = current.getParent()) {\n        if (current instanceof Gtk.ScrolledWindow) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n        if (current instanceof Gtk.Scrollable) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n    }\n    return null;\n};\n\nconst applyScrollDelta = (adjustment: Gtk.Adjustment | null, delta: number): void => {\n    if (!adjustment || delta === 0) return;\n    adjustment.setValue(adjustment.getValue() + delta);\n};\n\nexport const scroll = (widget: Gtk.Widget, delta: ScrollDelta): Promise<void> =>\n    wrapEvent(widget, () => {\n        const adjustments = resolveScrollAdjustments(widget);\n        if (!adjustments) {\n            throw new Error(\n                \"userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors\",\n            );\n        }\n        applyScrollDelta(adjustments.horizontal, delta.x ?? 0);\n        applyScrollDelta(adjustments.vertical, delta.y ?? 0);\n    });\n"]}
+{"version":3,"file":"adjustment.js","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAa/C,MAAM,KAAK,GAAG,CAAC,MAAkB,EAAE,KAAa,EAAiB,EAAE,CAC/D,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CACf,8DAA8D,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAC1F,CAAC;IACN,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEP,MAAM,wBAAwB,GAAG,CAAC,MAAkB,EAA4B,EAAE;IAC9E,KAAK,IAAI,OAAO,GAAsB,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACnF,IAAI,OAAO,YAAY,GAAG,CAAC,cAAc,EAAE,CAAC;YACxC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACxF,CAAC;QAED,IAAI,OAAO,YAAY,GAAG,CAAC,UAAU,EAAE,CAAC;YACpC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACxF,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,UAAiC,EAAE,KAAa,EAAQ,EAAE;IAChF,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;IACX,CAAC;IAED,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,KAAkB,EAAiB,EAAE,CACrE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACX,gGAAgG,CACnG,CAAC;IACN,CAAC;IAED,gBAAgB,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,gBAAgB,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEP,OAAO,EAAE,KAAK,EAAE,MAAM,EAAoB,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** A scroll distance in pixels along each axis. */\ntype ScrollDelta = {\n    x?: number;\n    y?: number;\n};\n\ntype ScrollAdjustments = {\n    horizontal: Gtk.Adjustment | null;\n    vertical: Gtk.Adjustment | null;\n};\n\nconst slide = (widget: Gtk.Widget, value: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!(widget instanceof Gtk.Range)) {\n            throw new TypeError(\n                `userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`,\n            );\n        }\n\n        widget.emit(\"change-value\", Gtk.ScrollType.JUMP, value);\n    });\n\nconst resolveScrollAdjustments = (widget: Gtk.Widget): ScrollAdjustments | null => {\n    for (let current: Gtk.Widget | null = widget; current; current = current.getParent()) {\n        if (current instanceof Gtk.ScrolledWindow) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n\n        if (current instanceof Gtk.Scrollable) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n    }\n\n    return null;\n};\n\nconst applyScrollDelta = (adjustment: Gtk.Adjustment | null, delta: number): void => {\n    if (!adjustment || delta === 0) {\n        return;\n    }\n\n    adjustment.setValue(adjustment.getValue() + delta);\n};\n\nconst scroll = (widget: Gtk.Widget, delta: ScrollDelta): Promise<void> =>\n    wrapEvent(widget, () => {\n        const adjustments = resolveScrollAdjustments(widget);\n\n        if (!adjustments) {\n            throw new Error(\n                \"userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors\",\n            );\n        }\n\n        applyScrollDelta(adjustments.horizontal, delta.x ?? 0);\n        applyScrollDelta(adjustments.vertical, delta.y ?? 0);\n    });\n\nexport { slide, scroll, type ScrollDelta };\n"]}

package/dist/user-event/click.d.ts

@@ -1,7 +1,8 @@
 import * as Gtk from "@gtkx/gi/gtk";
-export declare const emitPress: (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number) => void;
-export declare const emitRelease: (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number) => void;
-export declare const click: (widget: Gtk.Widget) => Promise<void>;
-export declare const dblClick: (widget: Gtk.Widget) => Promise<void>;
-export declare const tripleClick: (widget: Gtk.Widget) => Promise<void>;
+declare const emitPress: (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number) => void;
+declare const emitRelease: (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number) => void;
+declare const click: (widget: Gtk.Widget) => Promise<void>;
+declare const dblClick: (widget: Gtk.Widget) => Promise<void>;
+declare const tripleClick: (widget: Gtk.Widget) => Promise<void>;
+export { emitPress, emitRelease, click, dblClick, tripleClick };
 //# sourceMappingURL=click.d.ts.map

package/dist/user-event/click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAWpC,eAAO,MAAM,SAAS,WAAY,GAAG,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,UAAU,MAAM,KAAG,IAK/F,CAAC;AAEF,eAAO,MAAM,WAAW,WAAY,GAAG,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,UAAU,MAAM,KAAG,IAKjG,CAAC;AAuBF,eAAO,MAAM,KAAK,WAAkB,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAoB5D,CAAC;AAEF,eAAO,MAAM,QAAQ,WAAY,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyC,CAAC;AACpG,eAAO,MAAM,WAAW,WAAY,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyC,CAAC"}
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAuBpC,QAAA,MAAM,SAAS,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,YAAY,EAAE,EAAE,QAAQ,MAAM,KAAG,IAExF,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,YAAY,EAAE,EAAE,QAAQ,MAAM,KAAG,IAE1F,CAAC;AAwCF,QAAA,MAAM,KAAK,GAAU,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAwBrD,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyC,CAAC;AAC7F,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyC,CAAC;AAEhG,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

package/dist/user-event/click.js

@@ -1,24 +1,25 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { getOrCreateControllers, queryController } from "./controller.js";
 import { wrapEvent } from "./event-wrapper.js";
-const pressPointOf = (widget) => {
+const getPressPoint = (widget) => {
     const width = widget.getWidth();
     const height = widget.getHeight();
-    if (width > 0 && height > 0)
+    if (width > 0 && height > 0) {
         return { x: width / 2, y: height / 2 };
+    }
     return { x: 0, y: 0 };
 };
-export const emitPress = (widget, controllers, nPress) => {
-    const { x, y } = pressPointOf(widget);
+const emitGesture = (widget, controllers, nPress, signal) => {
+    const { x, y } = getPressPoint(widget);
     for (const controller of controllers) {
-        controller.emit("pressed", nPress, x, y);
+        controller.emit(signal, nPress, x, y);
     }
 };
-export const emitRelease = (widget, controllers, nPress) => {
-    const { x, y } = pressPointOf(widget);
-    for (const controller of controllers) {
-        controller.emit("released", nPress, x, y);
-    }
+const emitPress = (widget, controllers, nPress) => {
+    emitGesture(widget, controllers, nPress, "pressed");
+};
+const emitRelease = (widget, controllers, nPress) => {
+    emitGesture(widget, controllers, nPress, "released");
 };
 const emitClickSequence = (widget, target, nPress) => wrapEvent(widget, () => {
     const controllers = getOrCreateControllers(target, Gtk.GestureClick);
@@ -37,7 +38,17 @@ const findClickableAncestor = (widget) => {
     }
     return null;
 };
-export const click = async (widget) => {
+const tryActivate = async (widget) => {
+    if (widget.getAccessibleRole() === Gtk.AccessibleRole.LABEL) {
+        return false;
+    }
+    let isActivated = false;
+    await wrapEvent(widget, () => {
+        isActivated = widget.activate();
+    });
+    return isActivated;
+};
+const click = async (widget) => {
     if (widget instanceof Gtk.Button) {
         await emitClickSequence(widget, widget, 1);
         return;
@@ -48,18 +59,15 @@ export const click = async (widget) => {
         });
         return;
     }
-    if (widget.getAccessibleRole() !== Gtk.AccessibleRole.LABEL) {
-        let activated = false;
-        await wrapEvent(widget, () => {
-            activated = widget.activate();
-        });
-        if (activated)
-            return;
+    if (await tryActivate(widget)) {
+        return;
     }
     const target = findClickableAncestor(widget);
-    if (target)
+    if (target) {
         await emitClickSequence(widget, target, 1);
+    }
 };
-export const dblClick = (widget) => emitClickSequence(widget, widget, 2);
-export const tripleClick = (widget) => emitClickSequence(widget, widget, 3);
+const dblClick = (widget) => emitClickSequence(widget, widget, 2);
+const tripleClick = (widget) => emitClickSequence(widget, widget, 3);
+export { emitPress, emitRelease, click, dblClick, tripleClick };
 //# sourceMappingURL=click.js.map

package/dist/user-event/click.js.map

@@ -1 +1 @@
-{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { getOrCreateControllers, queryController } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\nconst pressPointOf = (widget: Gtk.Widget): { x: number; y: number } => {\n    const width = widget.getWidth();\n    const height = widget.getHeight();\n    if (width > 0 && height > 0) return { x: width / 2, y: height / 2 };\n    return { x: 0, y: 0 };\n};\n\nexport const emitPress = (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number): void => {\n    const { x, y } = pressPointOf(widget);\n    for (const controller of controllers) {\n        controller.emit(\"pressed\", nPress, x, y);\n    }\n};\n\nexport const emitRelease = (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number): void => {\n    const { x, y } = pressPointOf(widget);\n    for (const controller of controllers) {\n        controller.emit(\"released\", nPress, x, y);\n    }\n};\n\nconst emitClickSequence = (widget: Gtk.Widget, target: Gtk.Widget, nPress: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        const controllers = getOrCreateControllers(target, Gtk.GestureClick);\n\n        for (let i = 1; i <= nPress; i++) {\n            emitPress(target, controllers, i);\n            emitRelease(target, controllers, i);\n        }\n    });\n\nconst findClickableAncestor = (widget: Gtk.Widget): Gtk.Widget | null => {\n    let current = widget.getParent();\n    while (current) {\n        if (current instanceof Gtk.Button || queryController(current, Gtk.GestureClick) !== null) {\n            return current;\n        }\n        current = current.getParent();\n    }\n    return null;\n};\n\nexport const click = async (widget: Gtk.Widget): Promise<void> => {\n    if (widget instanceof Gtk.Button) {\n        await emitClickSequence(widget, widget, 1);\n        return;\n    }\n    if (widget instanceof Gtk.Switch) {\n        await wrapEvent(widget, () => {\n            widget.setActive(!widget.getActive());\n        });\n        return;\n    }\n    if (widget.getAccessibleRole() !== Gtk.AccessibleRole.LABEL) {\n        let activated = false;\n        await wrapEvent(widget, () => {\n            activated = widget.activate();\n        });\n        if (activated) return;\n    }\n    const target = findClickableAncestor(widget);\n    if (target) await emitClickSequence(widget, target, 1);\n};\n\nexport const dblClick = (widget: Gtk.Widget): Promise<void> => emitClickSequence(widget, widget, 2);\nexport const tripleClick = (widget: Gtk.Widget): Promise<void> => emitClickSequence(widget, widget, 3);\n"]}
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { getOrCreateControllers, queryController } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\nconst getPressPoint = (widget: Gtk.Widget): { x: number; y: number } => {\n    const width = widget.getWidth();\n    const height = widget.getHeight();\n\n    if (width > 0 && height > 0) {\n        return { x: width / 2, y: height / 2 };\n    }\n\n    return { x: 0, y: 0 };\n};\n\nconst emitGesture = (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number, signal: string): void => {\n    const { x, y } = getPressPoint(widget);\n\n    for (const controller of controllers) {\n        controller.emit(signal, nPress, x, y);\n    }\n};\n\nconst emitPress = (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number): void => {\n    emitGesture(widget, controllers, nPress, \"pressed\");\n};\n\nconst emitRelease = (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number): void => {\n    emitGesture(widget, controllers, nPress, \"released\");\n};\n\nconst emitClickSequence = (widget: Gtk.Widget, target: Gtk.Widget, nPress: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        const controllers = getOrCreateControllers(target, Gtk.GestureClick);\n\n        for (let i = 1; i <= nPress; i++) {\n            emitPress(target, controllers, i);\n            emitRelease(target, controllers, i);\n        }\n    });\n\nconst findClickableAncestor = (widget: Gtk.Widget): Gtk.Widget | null => {\n    let current = widget.getParent();\n\n    while (current) {\n        if (current instanceof Gtk.Button || queryController(current, Gtk.GestureClick) !== null) {\n            return current;\n        }\n\n        current = current.getParent();\n    }\n\n    return null;\n};\n\nconst tryActivate = async (widget: Gtk.Widget): Promise<boolean> => {\n    if (widget.getAccessibleRole() === Gtk.AccessibleRole.LABEL) {\n        return false;\n    }\n\n    let isActivated = false;\n\n    await wrapEvent(widget, () => {\n        isActivated = widget.activate();\n    });\n\n    return isActivated;\n};\n\nconst click = async (widget: Gtk.Widget): Promise<void> => {\n    if (widget instanceof Gtk.Button) {\n        await emitClickSequence(widget, widget, 1);\n\n        return;\n    }\n\n    if (widget instanceof Gtk.Switch) {\n        await wrapEvent(widget, () => {\n            widget.setActive(!widget.getActive());\n        });\n\n        return;\n    }\n\n    if (await tryActivate(widget)) {\n        return;\n    }\n\n    const target = findClickableAncestor(widget);\n\n    if (target) {\n        await emitClickSequence(widget, target, 1);\n    }\n};\n\nconst dblClick = (widget: Gtk.Widget): Promise<void> => emitClickSequence(widget, widget, 2);\nconst tripleClick = (widget: Gtk.Widget): Promise<void> => emitClickSequence(widget, widget, 3);\n\nexport { emitPress, emitRelease, click, dblClick, tripleClick };\n"]}

package/dist/user-event/controller.d.ts

@@ -1,7 +1,9 @@
 import type * as Gtk from "@gtkx/gi/gtk";
-export type ControllerConstructor<T extends Gtk.EventController> = new () => T;
-export declare const queryAllControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
-export declare const queryController: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T | null;
-export declare const getAllControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
-export declare const getOrCreateControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+type ControllerConstructor<T extends Gtk.EventController> = new () => T;
+declare const queryAllControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+declare const queryController: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T | null;
+declare const getAllControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+declare const getController: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T;
+declare const getOrCreateControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+export { queryAllControllers, queryController, getAllControllers, getController, getOrCreateControllers, type ControllerConstructor, };
 //# sourceMappingURL=controller.d.ts.map

package/dist/user-event/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC;AAE/E,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,UACrD,GAAG,CAAC,MAAM,kBACF,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EASH,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,UACjD,GAAG,CAAC,MAAM,kBACF,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,GAAG,IAA8D,CAAC;AAEtE,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,UACnD,GAAG,CAAC,MAAM,kBACF,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAMH,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,UACxD,GAAG,CAAC,MAAM,kBACF,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAMH,CAAC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAEzC,KAAK,qBAAqB,CAAC,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC;AAExE,QAAA,MAAM,mBAAmB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACtD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAcH,CAAC;AAEF,QAAA,MAAM,eAAe,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAClD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,GAAG,IAA8D,CAAC;AAEtE,QAAA,MAAM,iBAAiB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACpD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAQH,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAChD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAQF,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACzD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAWH,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,KAAK,qBAAqB,GAC7B,CAAC"}

package/dist/user-event/controller.js

@@ -1,28 +1,38 @@
-export const queryAllControllers = (widget, controllerType) => {
+const queryAllControllers = (widget, controllerType) => {
     const controllers = widget.observeControllers();
     const nItems = controllers.getNItems();
     const matches = [];
     for (let i = 0; i < nItems; i++) {
         const controller = controllers.getItem(i);
-        if (controller instanceof controllerType)
+        if (controller instanceof controllerType) {
             matches.push(controller);
+        }
     }
     return matches;
 };
-export const queryController = (widget, controllerType) => queryAllControllers(widget, controllerType)[0] ?? null;
-export const getAllControllers = (widget, controllerType) => {
+const queryController = (widget, controllerType) => queryAllControllers(widget, controllerType)[0] ?? null;
+const getAllControllers = (widget, controllerType) => {
     const controllers = queryAllControllers(widget, controllerType);
     if (controllers.length === 0) {
         throw new Error(`No ${controllerType.name} controller is attached to the widget`);
     }
     return controllers;
 };
-export const getOrCreateControllers = (widget, controllerType) => {
+const getController = (widget, controllerType) => {
+    const [controller] = getAllControllers(widget, controllerType);
+    if (controller === undefined) {
+        throw new Error(`No ${controllerType.name} controller is attached to the widget`);
+    }
+    return controller;
+};
+const getOrCreateControllers = (widget, controllerType) => {
     const existing = queryAllControllers(widget, controllerType);
-    if (existing.length > 0)
+    if (existing.length > 0) {
         return existing;
+    }
     const controller = new controllerType();
     widget.addController(controller);
     return [controller];
 };
+export { queryAllControllers, queryController, getAllControllers, getController, getOrCreateControllers, };
 //# sourceMappingURL=controller.js.map

package/dist/user-event/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAC/B,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,UAAU,YAAY,cAAc;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC3B,MAAkB,EAClB,cAAwC,EAChC,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAEtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC7B,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAClC,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\n\nexport type ControllerConstructor<T extends Gtk.EventController> = new () => T;\n\nexport const queryAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = widget.observeControllers();\n    const nItems = controllers.getNItems();\n    const matches: T[] = [];\n    for (let i = 0; i < nItems; i++) {\n        const controller = controllers.getItem(i);\n        if (controller instanceof controllerType) matches.push(controller);\n    }\n    return matches;\n};\n\nexport const queryController = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T | null => queryAllControllers(widget, controllerType)[0] ?? null;\n\nexport const getAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = queryAllControllers(widget, controllerType);\n    if (controllers.length === 0) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n    return controllers;\n};\n\nexport const getOrCreateControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const existing = queryAllControllers(widget, controllerType);\n    if (existing.length > 0) return existing;\n    const controller = new controllerType();\n    widget.addController(controller);\n    return [controller];\n};\n"]}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAIA,MAAM,mBAAmB,GAAG,CACxB,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE1C,IAAI,UAAU,YAAY,cAAc,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACpB,MAAkB,EAClB,cAAwC,EAChC,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAEtE,MAAM,iBAAiB,GAAG,CACtB,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAClB,MAAkB,EAClB,cAAwC,EACvC,EAAE;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE/D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAC3B,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,GAEzB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\n\ntype ControllerConstructor<T extends Gtk.EventController> = new () => T;\n\nconst queryAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = widget.observeControllers();\n    const nItems = controllers.getNItems();\n    const matches: T[] = [];\n\n    for (let i = 0; i < nItems; i++) {\n        const controller = controllers.getItem(i);\n\n        if (controller instanceof controllerType) {\n            matches.push(controller);\n        }\n    }\n\n    return matches;\n};\n\nconst queryController = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T | null => queryAllControllers(widget, controllerType)[0] ?? null;\n\nconst getAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = queryAllControllers(widget, controllerType);\n\n    if (controllers.length === 0) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n\n    return controllers;\n};\n\nconst getController = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T => {\n    const [controller] = getAllControllers(widget, controllerType);\n\n    if (controller === undefined) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n\n    return controller;\n};\n\nconst getOrCreateControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const existing = queryAllControllers(widget, controllerType);\n\n    if (existing.length > 0) {\n        return existing;\n    }\n\n    const controller = new controllerType();\n    widget.addController(controller);\n\n    return [controller];\n};\n\nexport {\n    queryAllControllers,\n    queryController,\n    getAllControllers,\n    getController,\n    getOrCreateControllers,\n    type ControllerConstructor,\n};\n"]}

package/dist/user-event/dispatch.d.ts

@@ -1,7 +1,7 @@
 import type * as Gtk from "@gtkx/gi/gtk";
 import { type ControllerConstructor } from "./controller.js";
 type ControllerEmit<T extends Gtk.EventController> = (controller: T) => void | PromiseLike<void>;
-export declare const dispatchOnOrCreateControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>, emit: ControllerEmit<T>) => Promise<void>;
-export declare const dispatchOnControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>, emit: ControllerEmit<T>) => Promise<void>;
-export {};
+declare const dispatchOnOrCreateControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>, emit: ControllerEmit<T>) => Promise<void>;
+declare const dispatchOnControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>, emit: ControllerEmit<T>) => Promise<void>;
+export { dispatchOnOrCreateControllers, dispatchOnControllers };
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/user-event/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/user-event/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,qBAAqB,EAA6C,MAAM,iBAAiB,CAAC;AAGxG,KAAK,cAAc,CAAC,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAQjG,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,UAC/D,GAAG,CAAC,MAAM,kBACF,qBAAqB,CAAC,CAAC,CAAC,QAClC,cAAc,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,IAAI,CAA6F,CAAC;AAE7G,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,UACvD,GAAG,CAAC,MAAM,kBACF,qBAAqB,CAAC,CAAC,CAAC,QAClC,cAAc,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,IAAI,CAAwF,CAAC"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/user-event/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,qBAAqB,EAA6C,MAAM,iBAAiB,CAAC;AAGxG,KAAK,cAAc,CAAC,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAQjG,QAAA,MAAM,6BAA6B,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAChE,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,EACxC,MAAM,cAAc,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,IAAI,CAA6F,CAAC;AAE7G,QAAA,MAAM,qBAAqB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACxD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,EACxC,MAAM,cAAc,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,IAAI,CAAwF,CAAC;AAExG,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/user-event/dispatch.js

@@ -5,6 +5,7 @@ const emitOnAll = async (controllers, emit) => {
         await emit(controller);
     }
 };
-export const dispatchOnOrCreateControllers = (widget, controllerType, emit) => wrapEvent(widget, () => emitOnAll(getOrCreateControllers(widget, controllerType), emit));
-export const dispatchOnControllers = (widget, controllerType, emit) => wrapEvent(widget, () => emitOnAll(getAllControllers(widget, controllerType), emit));
+const dispatchOnOrCreateControllers = (widget, controllerType, emit) => wrapEvent(widget, () => emitOnAll(getOrCreateControllers(widget, controllerType), emit));
+const dispatchOnControllers = (widget, controllerType, emit) => wrapEvent(widget, () => emitOnAll(getAllControllers(widget, controllerType), emit));
+export { dispatchOnOrCreateControllers, dispatchOnControllers };
 //# sourceMappingURL=dispatch.js.map

package/dist/user-event/dispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/user-event/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,MAAM,SAAS,GAAG,KAAK,EAAiC,WAAgB,EAAE,IAAuB,EAAiB,EAAE;IAChH,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CACzC,MAAkB,EAClB,cAAwC,EACxC,IAAuB,EACV,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAE7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,MAAkB,EAClB,cAAwC,EACxC,IAAuB,EACV,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { type ControllerConstructor, getAllControllers, getOrCreateControllers } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\ntype ControllerEmit<T extends Gtk.EventController> = (controller: T) => void | PromiseLike<void>;\n\nconst emitOnAll = async <T extends Gtk.EventController>(controllers: T[], emit: ControllerEmit<T>): Promise<void> => {\n    for (const controller of controllers) {\n        await emit(controller);\n    }\n};\n\nexport const dispatchOnOrCreateControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n    emit: ControllerEmit<T>,\n): Promise<void> => wrapEvent(widget, () => emitOnAll(getOrCreateControllers(widget, controllerType), emit));\n\nexport const dispatchOnControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n    emit: ControllerEmit<T>,\n): Promise<void> => wrapEvent(widget, () => emitOnAll(getAllControllers(widget, controllerType), emit));\n"]}
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/user-event/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,MAAM,SAAS,GAAG,KAAK,EAAiC,WAAgB,EAAE,IAAuB,EAAiB,EAAE;IAChH,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAClC,MAAkB,EAClB,cAAwC,EACxC,IAAuB,EACV,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAE7G,MAAM,qBAAqB,GAAG,CAC1B,MAAkB,EAClB,cAAwC,EACxC,IAAuB,EACV,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAExG,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { type ControllerConstructor, getAllControllers, getOrCreateControllers } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\ntype ControllerEmit<T extends Gtk.EventController> = (controller: T) => void | PromiseLike<void>;\n\nconst emitOnAll = async <T extends Gtk.EventController>(controllers: T[], emit: ControllerEmit<T>): Promise<void> => {\n    for (const controller of controllers) {\n        await emit(controller);\n    }\n};\n\nconst dispatchOnOrCreateControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n    emit: ControllerEmit<T>,\n): Promise<void> => wrapEvent(widget, () => emitOnAll(getOrCreateControllers(widget, controllerType), emit));\n\nconst dispatchOnControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n    emit: ControllerEmit<T>,\n): Promise<void> => wrapEvent(widget, () => emitOnAll(getAllControllers(widget, controllerType), emit));\n\nexport { dispatchOnOrCreateControllers, dispatchOnControllers };\n"]}

package/dist/user-event/event-wrapper.d.ts

@@ -1,3 +1,4 @@
 import * as Gtk from "@gtkx/gi/gtk";
-export declare const wrapEvent: (widget: Gtk.Widget, body: () => void | PromiseLike<void>) => Promise<void>;
+declare const wrapEvent: (widget: Gtk.Widget, body: () => void | PromiseLike<void>) => Promise<void>;
+export { wrapEvent };
 //# sourceMappingURL=event-wrapper.d.ts.map