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

package/dist/matchers.js

@@ -1,6 +1,27 @@
 /// <reference types="@vitest/expect" />
 import * as Gtk from "@gtkx/gi/gtk";
 import { getWidgetAccessibleName, getWidgetCheckedState, getWidgetDisplayValue, getWidgetExpandedState, getWidgetNodeText, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValue, } from "./widget-accessible-properties.js";
+const toHaveDisplayValue = textMatcher("toHaveDisplayValue", getWidgetDisplayValue, "exact");
+const toHaveTextContent = textMatcher("toHaveTextContent", (widget) => getWidgetNodeText(widget) ?? getWidgetAccessibleName(widget), "substring");
+const toHaveAccessibleName = textMatcher("toHaveAccessibleName", getWidgetAccessibleName, "exact");
+const toHavePlaceholderText = textMatcher("toHavePlaceholderText", getWidgetPlaceholderText, "exact");
+const toBeChecked = booleanStateMatcher("toBeChecked", "checked", getWidgetCheckedState);
+const toBePressed = booleanStateMatcher("toBePressed", "pressed", getWidgetPressedState);
+const toBeExpanded = booleanStateMatcher("toBeExpanded", "expanded", getWidgetExpandedState);
+const toBeSelected = booleanStateMatcher("toBeSelected", "selected", getWidgetSelectedState);
+/** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */
+const matchers = {
+    toHaveDisplayValue,
+    toHaveTextContent,
+    toHaveAccessibleName,
+    toHavePlaceholderText,
+    toBeChecked,
+    toBePressed,
+    toBeExpanded,
+    toBeSelected,
+    toHaveValue,
+};
+const registration = { isRegistered: false };
 const asWidget = (received, matcherName) => {
     if (!(received instanceof Gtk.Widget)) {
         throw new TypeError(`${matcherName}: received value must be a Gtk.Widget, got ${typeof received}`);
@@ -10,9 +31,9 @@ const asWidget = (received, matcherName) => {
 const describeWidget = (widget) => {
     const role = Gtk.AccessibleRole[widget.getAccessibleRole()];
     const name = getWidgetAccessibleName(widget);
-    return name !== null ? `<${role} name=${JSON.stringify(name)}>` : `<${role}>`;
+    return name === null ? `<${role}>` : `<${role} name=${JSON.stringify(name)}>`;
 };
-const matchesText = (actual, expected, mode) => {
+const isTextMatch = (actual, expected, mode) => {
     if (expected instanceof RegExp) {
         expected.lastIndex = 0;
         return expected.test(actual);
@@ -20,68 +41,59 @@ const matchesText = (actual, expected, mode) => {
     return mode === "exact" ? actual === expected : actual.includes(expected);
 };
 const describeExpected = (expected) => expected instanceof RegExp ? String(expected) : JSON.stringify(expected);
-const textMatcher = (matcherName, read, mode) => function (received, expected) {
-    const widget = asWidget(received, matcherName);
-    const actual = read(widget);
-    if (expected === undefined) {
-        const pass = actual !== null && actual !== "";
-        return {
-            pass,
-            message: () => `expected widget ${this.isNot ? "not " : ""}to have a non-empty value for ${matcherName}, ` +
-                `but got ${JSON.stringify(actual)}\n${describeWidget(widget)}`,
-        };
-    }
-    const pass = actual !== null && matchesText(actual, expected, mode);
+const negationPrefix = (isPass) => (isPass ? "not " : "");
+const nonEmptyResult = ({ matcherName, widget, actual }) => {
+    const isPass = actual !== null && actual !== "";
     return {
-        pass,
-        message: () => `expected widget ${this.isNot ? "not " : ""}${matcherName} ${describeExpected(expected)}, ` +
-            `but received ${JSON.stringify(actual)}\n${describeWidget(widget)}`,
+        pass: isPass,
+        message: () => `expected widget ${negationPrefix(isPass)}to have a non-empty value for ${matcherName}, ` +
+            `but got ${JSON.stringify(actual)}\n${describeWidget(widget)}`,
     };
 };
-const booleanStateMatcher = (matcherName, stateName, read) => function (received) {
-    const widget = asWidget(received, matcherName);
-    const state = read(widget);
-    if (state === null) {
-        throw new Error(`${matcherName}: widget does not expose a ${stateName} state ` +
-            `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\n${describeWidget(widget)}`);
-    }
-    return {
-        pass: state,
-        message: () => `expected widget ${this.isNot ? "not " : ""}to be ${stateName}\n${describeWidget(widget)}`,
+const matchedResult = (context, expected, isPass) => ({
+    pass: isPass,
+    message: () => `expected widget ${negationPrefix(isPass)}${context.matcherName} ${describeExpected(expected)}, ` +
+        `but received ${JSON.stringify(context.actual)}\n${describeWidget(context.widget)}`,
+});
+function textMatcher(matcherName, read, mode) {
+    return (received, expected) => {
+        const widget = asWidget(received, matcherName);
+        const actual = read(widget);
+        const context = { matcherName, widget, actual };
+        if (expected === undefined) {
+            return nonEmptyResult(context);
+        }
+        return matchedResult(context, expected, actual !== null && isTextMatch(actual, expected, mode));
     };
-};
-export const toHaveDisplayValue = textMatcher("toHaveDisplayValue", getWidgetDisplayValue, "exact");
-export const toHaveTextContent = textMatcher("toHaveTextContent", (widget) => getWidgetNodeText(widget) ?? getWidgetAccessibleName(widget), "substring");
-export const toHaveAccessibleName = textMatcher("toHaveAccessibleName", getWidgetAccessibleName, "exact");
-export const toHavePlaceholderText = textMatcher("toHavePlaceholderText", getWidgetPlaceholderText, "exact");
-export const toBeChecked = booleanStateMatcher("toBeChecked", "checked", getWidgetCheckedState);
-export const toBePressed = booleanStateMatcher("toBePressed", "pressed", getWidgetPressedState);
-export const toBeExpanded = booleanStateMatcher("toBeExpanded", "expanded", getWidgetExpandedState);
-export const toBeSelected = booleanStateMatcher("toBeSelected", "selected", getWidgetSelectedState);
-export const toHaveValue = function (received, expected) {
+}
+function booleanStateMatcher(matcherName, stateName, read) {
+    return (received) => {
+        const widget = asWidget(received, matcherName);
+        const state = read(widget);
+        if (state === null) {
+            throw new Error(`${matcherName}: widget does not expose a ${stateName} state ` +
+                `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\n${describeWidget(widget)}`);
+        }
+        return {
+            pass: state,
+            message: () => `expected widget ${negationPrefix(state)}to be ${stateName}\n${describeWidget(widget)}`,
+        };
+    };
+}
+function toHaveValue(received, expected) {
     const widget = asWidget(received, "toHaveValue");
     const actual = getWidgetValue(widget).now;
     if (actual === null) {
-        throw new Error(`toHaveValue: widget does not expose a numeric value ` +
+        throw new Error("toHaveValue: widget does not expose a numeric value " +
             `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\n${describeWidget(widget)}`);
     }
+    const isPass = actual === expected;
     return {
-        pass: actual === expected,
-        message: () => `expected widget ${this.isNot ? "not " : ""}to have value ${expected}, but received ${actual}\n${describeWidget(widget)}`,
+        pass: isPass,
+        message: () => `expected widget ${negationPrefix(isPass)}to have value ${String(expected)}, ` +
+            `but received ${String(actual)}\n${describeWidget(widget)}`,
     };
-};
-/** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */
-export const matchers = {
-    toHaveDisplayValue,
-    toHaveTextContent,
-    toHaveAccessibleName,
-    toHavePlaceholderText,
-    toBeChecked,
-    toBePressed,
-    toBeExpanded,
-    toBeSelected,
-    toHaveValue,
-};
+}
 const globalExpect = () => {
     const candidate = Reflect.get(globalThis, "expect");
     if (candidate && typeof candidate.extend === "function") {
@@ -89,15 +101,17 @@ const globalExpect = () => {
     }
     return null;
 };
-let registered = false;
 /** Registers the widget matchers on the global `expect`, when one is available. Safe to call more than once. */
-export const registerMatchers = () => {
-    if (registered)
+const registerMatchers = () => {
+    if (registration.isRegistered) {
         return;
+    }
     const expect = globalExpect();
-    if (!expect)
+    if (!expect) {
         return;
+    }
     expect.extend(matchers);
-    registered = true;
+    registration.isRegistered = true;
 };
+export { toHaveDisplayValue, toHaveTextContent, toHaveAccessibleName, toHavePlaceholderText, toBeChecked, toBePressed, toBeExpanded, toBeSelected, matchers, toHaveValue, registerMatchers, };
 //# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

@@ -1 +1 @@
-{"version":3,"file":"matchers.js","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference types=\"@vitest/expect\" />\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    getWidgetAccessibleName,\n    getWidgetCheckedState,\n    getWidgetDisplayValue,\n    getWidgetExpandedState,\n    getWidgetNodeText,\n    getWidgetPlaceholderText,\n    getWidgetPressedState,\n    getWidgetSelectedState,\n    getWidgetValue,\n} from \"./widget-accessible-properties.js\";\n\n/** The expected value for a text matcher: an exact string or a regular expression. */\nexport type TextExpectation = string | RegExp;\n\ntype MatcherResult = { pass: boolean; message: () => string };\n\ninterface MatcherContext {\n    isNot: boolean;\n}\n\ntype TextMatcher = (this: MatcherContext, received: unknown, expected?: TextExpectation) => MatcherResult;\ntype StateMatcher = (this: MatcherContext, received: unknown) => MatcherResult;\ntype ValueMatcher = (this: MatcherContext, received: unknown, expected: number) => MatcherResult;\n\nconst asWidget = (received: unknown, matcherName: string): Gtk.Widget => {\n    if (!(received instanceof Gtk.Widget)) {\n        throw new TypeError(`${matcherName}: received value must be a Gtk.Widget, got ${typeof received}`);\n    }\n    return received;\n};\n\nconst describeWidget = (widget: Gtk.Widget): string => {\n    const role = Gtk.AccessibleRole[widget.getAccessibleRole()];\n    const name = getWidgetAccessibleName(widget);\n    return name !== null ? `<${role} name=${JSON.stringify(name)}>` : `<${role}>`;\n};\n\nconst matchesText = (actual: string, expected: TextExpectation, mode: \"exact\" | \"substring\"): boolean => {\n    if (expected instanceof RegExp) {\n        expected.lastIndex = 0;\n        return expected.test(actual);\n    }\n    return mode === \"exact\" ? actual === expected : actual.includes(expected);\n};\n\nconst describeExpected = (expected: TextExpectation): string =>\n    expected instanceof RegExp ? String(expected) : JSON.stringify(expected);\n\nconst textMatcher = (\n    matcherName: string,\n    read: (widget: Gtk.Widget) => string | null,\n    mode: \"exact\" | \"substring\",\n): TextMatcher =>\n    function (this: MatcherContext, received: unknown, expected?: TextExpectation): MatcherResult {\n        const widget = asWidget(received, matcherName);\n        const actual = read(widget);\n\n        if (expected === undefined) {\n            const pass = actual !== null && actual !== \"\";\n            return {\n                pass,\n                message: () =>\n                    `expected widget ${this.isNot ? \"not \" : \"\"}to have a non-empty value for ${matcherName}, ` +\n                    `but got ${JSON.stringify(actual)}\\n${describeWidget(widget)}`,\n            };\n        }\n\n        const pass = actual !== null && matchesText(actual, expected, mode);\n        return {\n            pass,\n            message: () =>\n                `expected widget ${this.isNot ? \"not \" : \"\"}${matcherName} ${describeExpected(expected)}, ` +\n                `but received ${JSON.stringify(actual)}\\n${describeWidget(widget)}`,\n        };\n    };\n\nconst booleanStateMatcher = (\n    matcherName: string,\n    stateName: string,\n    read: (widget: Gtk.Widget) => boolean | null,\n): StateMatcher =>\n    function (this: MatcherContext, received: unknown): MatcherResult {\n        const widget = asWidget(received, matcherName);\n        const state = read(widget);\n        if (state === null) {\n            throw new Error(\n                `${matcherName}: widget does not expose a ${stateName} state ` +\n                    `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\\n${describeWidget(widget)}`,\n            );\n        }\n        return {\n            pass: state,\n            message: () => `expected widget ${this.isNot ? \"not \" : \"\"}to be ${stateName}\\n${describeWidget(widget)}`,\n        };\n    };\n\nexport const toHaveDisplayValue: TextMatcher = textMatcher(\"toHaveDisplayValue\", getWidgetDisplayValue, \"exact\");\nexport const toHaveTextContent: TextMatcher = textMatcher(\n    \"toHaveTextContent\",\n    (widget) => getWidgetNodeText(widget) ?? getWidgetAccessibleName(widget),\n    \"substring\",\n);\nexport const toHaveAccessibleName: TextMatcher = textMatcher(\"toHaveAccessibleName\", getWidgetAccessibleName, \"exact\");\nexport const toHavePlaceholderText: TextMatcher = textMatcher(\n    \"toHavePlaceholderText\",\n    getWidgetPlaceholderText,\n    \"exact\",\n);\n\nexport const toBeChecked: StateMatcher = booleanStateMatcher(\"toBeChecked\", \"checked\", getWidgetCheckedState);\nexport const toBePressed: StateMatcher = booleanStateMatcher(\"toBePressed\", \"pressed\", getWidgetPressedState);\nexport const toBeExpanded: StateMatcher = booleanStateMatcher(\"toBeExpanded\", \"expanded\", getWidgetExpandedState);\nexport const toBeSelected: StateMatcher = booleanStateMatcher(\"toBeSelected\", \"selected\", getWidgetSelectedState);\n\nexport const toHaveValue: ValueMatcher = function (\n    this: MatcherContext,\n    received: unknown,\n    expected: number,\n): MatcherResult {\n    const widget = asWidget(received, \"toHaveValue\");\n    const actual = getWidgetValue(widget).now;\n    if (actual === null) {\n        throw new Error(\n            `toHaveValue: widget does not expose a numeric value ` +\n                `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\\n${describeWidget(widget)}`,\n        );\n    }\n    return {\n        pass: actual === expected,\n        message: () =>\n            `expected widget ${this.isNot ? \"not \" : \"\"}to have value ${expected}, but received ${actual}\\n${describeWidget(widget)}`,\n    };\n};\n\ninterface MatcherImplementations {\n    toHaveDisplayValue: TextMatcher;\n    toHaveTextContent: TextMatcher;\n    toHaveAccessibleName: TextMatcher;\n    toHavePlaceholderText: TextMatcher;\n    toBeChecked: StateMatcher;\n    toBePressed: StateMatcher;\n    toBeExpanded: StateMatcher;\n    toBeSelected: StateMatcher;\n    toHaveValue: ValueMatcher;\n}\n\n/** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */\nexport const matchers: MatcherImplementations = {\n    toHaveDisplayValue,\n    toHaveTextContent,\n    toHaveAccessibleName,\n    toHavePlaceholderText,\n    toBeChecked,\n    toBePressed,\n    toBeExpanded,\n    toBeSelected,\n    toHaveValue,\n};\n\ntype ExpectExtend = { extend: (m: MatcherImplementations) => void };\n\nconst globalExpect = (): ExpectExtend | null => {\n    const candidate: unknown = Reflect.get(globalThis, \"expect\");\n    if (candidate && typeof (candidate as ExpectExtend).extend === \"function\") {\n        return candidate as ExpectExtend;\n    }\n    return null;\n};\n\nlet registered = false;\n\n/** Registers the widget matchers on the global `expect`, when one is available. Safe to call more than once. */\nexport const registerMatchers = (): void => {\n    if (registered) return;\n    const expect = globalExpect();\n    if (!expect) return;\n    expect.extend(matchers);\n    registered = true;\n};\n\ninterface WidgetMatchers<R = void> {\n    toHaveDisplayValue(expected?: TextExpectation): R;\n    toHaveTextContent(expected?: TextExpectation): R;\n    toHaveAccessibleName(expected?: TextExpectation): R;\n    toHavePlaceholderText(expected?: TextExpectation): R;\n    toBeChecked(): R;\n    toBePressed(): R;\n    toBeExpanded(): R;\n    toBeSelected(): R;\n    toHaveValue(expected: number): R;\n}\n\ndeclare module \"@vitest/expect\" {\n    // biome-ignore lint/suspicious/noExplicitAny: must match the `Assertion<T>` signature it augments for declaration merging\n    interface Assertion<T = any> extends WidgetMatchers {}\n    interface AsymmetricMatchersContaining extends WidgetMatchers {}\n}\n"]}
+{"version":3,"file":"matchers.js","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference types=\"@vitest/expect\" />\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    getWidgetAccessibleName,\n    getWidgetCheckedState,\n    getWidgetDisplayValue,\n    getWidgetExpandedState,\n    getWidgetNodeText,\n    getWidgetPlaceholderText,\n    getWidgetPressedState,\n    getWidgetSelectedState,\n    getWidgetValue,\n} from \"./widget-accessible-properties.js\";\n\n/** The expected value for a text matcher: an exact string or a regular expression. */\ntype TextExpectation = string | RegExp;\ntype MatcherResult = { pass: boolean; message: () => string };\ntype TextMatcher = (received: unknown, expected?: TextExpectation) => MatcherResult;\ntype StateMatcher = (received: unknown) => MatcherResult;\ntype ValueMatcher = (received: unknown, expected: number) => MatcherResult;\ntype TextMatcherContext = { matcherName: string; widget: Gtk.Widget; actual: string | null };\n\ntype MatcherImplementations = {\n    toHaveDisplayValue: TextMatcher;\n    toHaveTextContent: TextMatcher;\n    toHaveAccessibleName: TextMatcher;\n    toHavePlaceholderText: TextMatcher;\n    toBeChecked: StateMatcher;\n    toBePressed: StateMatcher;\n    toBeExpanded: StateMatcher;\n    toBeSelected: StateMatcher;\n    toHaveValue: ValueMatcher;\n};\n\ntype ExpectExtend = { extend: (m: MatcherImplementations) => void };\n\nconst toHaveDisplayValue: TextMatcher = textMatcher(\"toHaveDisplayValue\", getWidgetDisplayValue, \"exact\");\n\nconst toHaveTextContent: TextMatcher = textMatcher(\n    \"toHaveTextContent\",\n    (widget) => getWidgetNodeText(widget) ?? getWidgetAccessibleName(widget),\n    \"substring\",\n);\n\nconst toHaveAccessibleName: TextMatcher = textMatcher(\"toHaveAccessibleName\", getWidgetAccessibleName, \"exact\");\n\nconst toHavePlaceholderText: TextMatcher = textMatcher(\n    \"toHavePlaceholderText\",\n    getWidgetPlaceholderText,\n    \"exact\",\n);\n\nconst toBeChecked: StateMatcher = booleanStateMatcher(\"toBeChecked\", \"checked\", getWidgetCheckedState);\nconst toBePressed: StateMatcher = booleanStateMatcher(\"toBePressed\", \"pressed\", getWidgetPressedState);\nconst toBeExpanded: StateMatcher = booleanStateMatcher(\"toBeExpanded\", \"expanded\", getWidgetExpandedState);\nconst toBeSelected: StateMatcher = booleanStateMatcher(\"toBeSelected\", \"selected\", getWidgetSelectedState);\n\n/** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */\nconst matchers: MatcherImplementations = {\n    toHaveDisplayValue,\n    toHaveTextContent,\n    toHaveAccessibleName,\n    toHavePlaceholderText,\n    toBeChecked,\n    toBePressed,\n    toBeExpanded,\n    toBeSelected,\n    toHaveValue,\n};\n\nconst registration = { isRegistered: false };\n\nconst asWidget = (received: unknown, matcherName: string): Gtk.Widget => {\n    if (!(received instanceof Gtk.Widget)) {\n        throw new TypeError(`${matcherName}: received value must be a Gtk.Widget, got ${typeof received}`);\n    }\n\n    return received;\n};\n\nconst describeWidget = (widget: Gtk.Widget): string => {\n    const role = Gtk.AccessibleRole[widget.getAccessibleRole()];\n    const name = getWidgetAccessibleName(widget);\n\n    return name === null ? `<${role}>` : `<${role} name=${JSON.stringify(name)}>`;\n};\n\nconst isTextMatch = (actual: string, expected: TextExpectation, mode: \"exact\" | \"substring\"): boolean => {\n    if (expected instanceof RegExp) {\n        expected.lastIndex = 0;\n\n        return expected.test(actual);\n    }\n\n    return mode === \"exact\" ? actual === expected : actual.includes(expected);\n};\n\nconst describeExpected = (expected: TextExpectation): string =>\n    expected instanceof RegExp ? String(expected) : JSON.stringify(expected);\n\nconst negationPrefix = (isPass: boolean): string => (isPass ? \"not \" : \"\");\n\nconst nonEmptyResult = ({ matcherName, widget, actual }: TextMatcherContext): MatcherResult => {\n    const isPass = actual !== null && actual !== \"\";\n\n    return {\n        pass: isPass,\n        message: () =>\n            `expected widget ${negationPrefix(isPass)}to have a non-empty value for ${matcherName}, ` +\n            `but got ${JSON.stringify(actual)}\\n${describeWidget(widget)}`,\n    };\n};\n\nconst matchedResult = (context: TextMatcherContext, expected: TextExpectation, isPass: boolean): MatcherResult => ({\n    pass: isPass,\n    message: () =>\n        `expected widget ${negationPrefix(isPass)}${context.matcherName} ${describeExpected(expected)}, ` +\n        `but received ${JSON.stringify(context.actual)}\\n${describeWidget(context.widget)}`,\n});\n\nfunction textMatcher(\n    matcherName: string,\n    read: (widget: Gtk.Widget) => string | null,\n    mode: \"exact\" | \"substring\",\n): TextMatcher {\n    return (received: unknown, expected?: TextExpectation): MatcherResult => {\n        const widget = asWidget(received, matcherName);\n        const actual = read(widget);\n        const context: TextMatcherContext = { matcherName, widget, actual };\n\n        if (expected === undefined) {\n            return nonEmptyResult(context);\n        }\n\n        return matchedResult(context, expected, actual !== null && isTextMatch(actual, expected, mode));\n    };\n}\n\nfunction booleanStateMatcher(\n    matcherName: string,\n    stateName: string,\n    read: (widget: Gtk.Widget) => boolean | null,\n): StateMatcher {\n    return (received: unknown): MatcherResult => {\n        const widget = asWidget(received, matcherName);\n        const state = read(widget);\n\n        if (state === null) {\n            throw new Error(\n                `${matcherName}: widget does not expose a ${stateName} state ` +\n                `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\\n${describeWidget(widget)}`,\n            );\n        }\n\n        return {\n            pass: state,\n            message: () =>\n                `expected widget ${negationPrefix(state)}to be ${stateName}\\n${describeWidget(widget)}`,\n        };\n    };\n}\n\nfunction toHaveValue(received: unknown, expected: number): MatcherResult {\n    const widget = asWidget(received, \"toHaveValue\");\n    const actual = getWidgetValue(widget).now;\n\n    if (actual === null) {\n        throw new Error(\n            \"toHaveValue: widget does not expose a numeric value \" +\n            `(role ${Gtk.AccessibleRole[widget.getAccessibleRole()]})\\n${describeWidget(widget)}`,\n        );\n    }\n\n    const isPass = actual === expected;\n\n    return {\n        pass: isPass,\n        message: () =>\n            `expected widget ${negationPrefix(isPass)}to have value ${String(expected)}, ` +\n            `but received ${String(actual)}\\n${describeWidget(widget)}`,\n    };\n}\n\nconst globalExpect = (): ExpectExtend | null => {\n    const candidate: unknown = Reflect.get(globalThis, \"expect\");\n\n    if (candidate && typeof (candidate as ExpectExtend).extend === \"function\") {\n        return candidate as ExpectExtend;\n    }\n\n    return null;\n};\n\n/** Registers the widget matchers on the global `expect`, when one is available. Safe to call more than once. */\nconst registerMatchers = (): void => {\n    if (registration.isRegistered) {\n        return;\n    }\n\n    const expect = globalExpect();\n\n    if (!expect) {\n        return;\n    }\n\n    expect.extend(matchers);\n    registration.isRegistered = true;\n};\n\ndeclare module \"@vitest/expect\" {\n    /* eslint-disable @typescript-eslint/consistent-type-definitions -- declaration merging requires interfaces */\n    interface Assertion {\n        toHaveDisplayValue(expected?: TextExpectation): void;\n        toHaveTextContent(expected?: TextExpectation): void;\n        toHaveAccessibleName(expected?: TextExpectation): void;\n        toHavePlaceholderText(expected?: TextExpectation): void;\n        toBeChecked(): void;\n        toBePressed(): void;\n        toBeExpanded(): void;\n        toBeSelected(): void;\n        toHaveValue(expected: number): void;\n    }\n\n    interface AsymmetricMatchersContaining {\n        toHaveDisplayValue(expected?: TextExpectation): void;\n        toHaveTextContent(expected?: TextExpectation): void;\n        toHaveAccessibleName(expected?: TextExpectation): void;\n        toHavePlaceholderText(expected?: TextExpectation): void;\n        toBeChecked(): void;\n        toBePressed(): void;\n        toBeExpanded(): void;\n        toBeSelected(): void;\n        toHaveValue(expected: number): void;\n    }\n    /* eslint-enable @typescript-eslint/consistent-type-definitions */\n}\n\nexport {\n    toHaveDisplayValue,\n    toHaveTextContent,\n    toHaveAccessibleName,\n    toHavePlaceholderText,\n    toBeChecked,\n    toBePressed,\n    toBeExpanded,\n    toBeSelected,\n    matchers,\n    toHaveValue,\n    registerMatchers,\n    type TextExpectation,\n};\n"]}

package/dist/pretty-widget.d.ts

@@ -5,13 +5,15 @@ type WidgetIdResolver = (widget: Gtk.Widget) => string;
  * Options controlling how a widget tree is rendered to a string by
  * {@link prettyWidget} and {@link logWidget}.
  */
-export type PrettyWidgetOptions = {
+type PrettyWidgetOptions = {
     /** Truncates the output once it exceeds this many characters. */
     maxLength?: number;
     /** Whether to apply ANSI color highlighting; defaults to the terminal capabilities. */
     highlight?: boolean;
     /** Resolves an `id` attribute to show for each widget. */
     getId?: WidgetIdResolver;
+    /** Stops descending past this depth, replacing deeper children with a summary line. */
+    maxDepth?: number;
 };
 /**
  * Renders a widget tree as an indented, HTML-like string showing each widget's
@@ -21,13 +23,13 @@ export type PrettyWidgetOptions = {
  * @param options Formatting options such as truncation length and highlighting.
  * @returns The formatted representation of the tree.
  */
-export declare const prettyWidget: (container: Container, options?: PrettyWidgetOptions) => string;
+declare const prettyWidget: (container: Container, options?: PrettyWidgetOptions) => string;
 /**
  * Prints one or more widget trees to the console using {@link prettyWidget}.
  *
  * @param container A single scope or an array of scopes to format and print.
  * @param options Formatting options passed through to {@link prettyWidget}.
  */
-export declare const logWidget: (container: Container | Container[], options?: PrettyWidgetOptions) => void;
-export {};
+declare const logWidget: (container: Container | Container[], options?: PrettyWidgetOptions) => void;
+export { prettyWidget, logWidget, type PrettyWidgetOptions };
 //# sourceMappingURL=pretty-widget.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pretty-widget.d.ts","sourceRoot":"","sources":["../src/pretty-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,gBAAgB,CAAC;AAMvD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAqGF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,cAAe,SAAS,YAAW,mBAAmB,KAAQ,MAqBtF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,cAAe,SAAS,GAAG,SAAS,EAAE,YAAY,mBAAmB,KAAG,IAK7F,CAAC"}
+{"version":3,"file":"pretty-widget.d.ts","sourceRoot":"","sources":["../src/pretty-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,gBAAgB,CAAC;AAGvD,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;AAEvD;;;GAGG;AACH,KAAK,mBAAmB,GAAG;IACvB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA4KF;;;;;;;GAOG;AACH,QAAA,MAAM,YAAY,GAAI,WAAW,SAAS,EAAE,UAAS,mBAAwB,KAAG,MAoB/E,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,SAAS,GAAI,WAAW,SAAS,GAAG,SAAS,EAAE,EAAE,UAAU,mBAAmB,KAAG,IAMtF,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/pretty-widget.js

@@ -4,6 +4,12 @@ import { roots } from "./traversal.js";
 import { getWidgetNodeText } from "./widget-accessible-properties.js";
 const DEFAULT_MAX_LENGTH = 7000;
 const INDENT = "  ";
+const ansi = {
+    cyan: "\u{1B}[36m",
+    yellow: "\u{1B}[33m",
+    green: "\u{1B}[32m",
+    reset: "\u{1B}[0m",
+};
 const buildAttrs = (widget, getId) => {
     const attrs = [];
     if (getId) {
@@ -24,23 +30,20 @@ const buildAttrs = (widget, getId) => {
     const otherAttrs = sortStringsBy(attrs.filter(([key]) => key !== "id"), ([key]) => key);
     return [...idAttrs, ...otherAttrs];
 };
-const ansi = {
-    cyan: "\x1b[36m",
-    yellow: "\x1b[33m",
-    green: "\x1b[32m",
-    reset: "\x1b[0m",
-};
 const shouldHighlight = () => {
-    if (typeof process === "undefined")
+    if (typeof process === "undefined") {
         return false;
-    if (process.env.COLORS === "false" || process.env.NO_COLOR)
+    }
+    if (process.env.COLORS === "false" || process.env.NO_COLOR) {
         return false;
-    if (process.env.COLORS === "true" || process.env.FORCE_COLOR)
+    }
+    if (process.env.COLORS === "true" || process.env.FORCE_COLOR) {
         return true;
+    }
     return process.stdout.isTTY;
 };
-const createColors = (enabled) => {
-    if (!enabled) {
+const createColors = (isEnabled) => {
+    if (!isEnabled) {
         const identity = (s) => s;
         return { tag: identity, attr: identity, value: identity };
     }
@@ -51,8 +54,40 @@ const createColors = (enabled) => {
     };
 };
 const escapeAttrValue = (value) => value.replaceAll('"', """);
-const formatAttrs = (attrs, colors) => attrs.map(([key, value]) => ` ${colors.attr(key)}=${colors.value(`"${escapeAttrValue(value)}"`)}`).join("");
-const formatWidget = (widget, depth, getId, colors) => {
+const formatAttr = (key, value, colors) => {
+    const quoted = `"${escapeAttrValue(value)}"`;
+    return ` ${colors.attr(key)}=${colors.value(quoted)}`;
+};
+const formatAttrs = (attrs, colors) => attrs.map(([key, value]) => formatAttr(key, value, colors)).join("");
+const countChildren = (widget) => {
+    let count = 0;
+    let child = widget.getFirstChild();
+    while (child) {
+        count += 1;
+        child = child.getNextSibling();
+    }
+    return count;
+};
+const formatHiddenChildrenLine = (widget, depth, ctx) => {
+    const { getId, colors } = ctx;
+    const indent = INDENT.repeat(depth);
+    const count = countChildren(widget);
+    const hint = getId ? ` (pass rootId="${getId(widget)}" or raise maxDepth to expand)` : "";
+    const plural = count === 1 ? "" : "s";
+    const summary = `… ${String(count)} child widget${plural} hidden${hint}`;
+    return `${indent}${INDENT}${colors.tag(summary)}\n`;
+};
+const formatChildren = (widget, depth, ctx) => {
+    let output = "";
+    let child = widget.getFirstChild();
+    while (child) {
+        output += formatWidget(child, depth + 1, ctx);
+        child = child.getNextSibling();
+    }
+    return output;
+};
+const formatWidget = (widget, depth, ctx) => {
+    const { getId, colors, maxDepth } = ctx;
     const indent = INDENT.repeat(depth);
     const tag = widget.constructor.name;
     const attrs = formatAttrs(buildAttrs(widget, getId), colors);
@@ -67,14 +102,19 @@ const formatWidget = (widget, depth, getId, colors) => {
     if (text) {
         output += `${indent}${INDENT}${text}\n`;
     }
-    let child = firstChild;
-    while (child) {
-        output += formatWidget(child, depth + 1, getId, colors);
-        child = child.getNextSibling();
+    if (firstChild && maxDepth !== undefined && depth >= maxDepth) {
+        output += formatHiddenChildrenLine(widget, depth, ctx);
+        output += `${indent}${closeTag}\n`;
+        return output;
     }
+    output += formatChildren(widget, depth, ctx);
     output += `${indent}${closeTag}\n`;
     return output;
 };
+const resolveMaxLength = (options) => {
+    const envLimit = process.env.DEBUG_PRINT_LIMIT ? Number(process.env.DEBUG_PRINT_LIMIT) : DEFAULT_MAX_LENGTH;
+    return options.maxLength ?? envLimit;
+};
 /**
  * Renders a widget tree as an indented, HTML-like string showing each widget's
  * tag, accessible attributes, and text content.
@@ -83,17 +123,16 @@ const formatWidget = (widget, depth, getId, colors) => {
  * @param options Formatting options such as truncation length and highlighting.
  * @returns The formatted representation of the tree.
  */
-export const prettyWidget = (container, options = {}) => {
-    const envLimit = process.env.DEBUG_PRINT_LIMIT ? Number(process.env.DEBUG_PRINT_LIMIT) : DEFAULT_MAX_LENGTH;
-    const maxLength = options.maxLength ?? envLimit;
+const prettyWidget = (container, options = {}) => {
+    const maxLength = resolveMaxLength(options);
     if (maxLength === 0) {
         return "";
     }
-    const highlight = options.highlight ?? shouldHighlight();
-    const colors = createColors(highlight);
+    const isHighlight = options.highlight ?? shouldHighlight();
+    const colors = createColors(isHighlight);
     let output = "";
     for (const root of roots(container)) {
-        output += formatWidget(root, 0, options.getId, colors);
+        output += formatWidget(root, 0, { getId: options.getId, colors, maxDepth: options.maxDepth });
     }
     if (output.length > maxLength) {
         return `${output.slice(0, maxLength)}...`;
@@ -106,10 +145,11 @@ export const prettyWidget = (container, options = {}) => {
  * @param container A single scope or an array of scopes to format and print.
  * @param options Formatting options passed through to {@link prettyWidget}.
  */
-export const logWidget = (container, options) => {
+const logWidget = (container, options) => {
     const containers = Array.isArray(container) ? container : [container];
     for (const target of containers) {
         console.log(prettyWidget(target, options));
     }
 };
+export { prettyWidget, logWidget };
 //# sourceMappingURL=pretty-widget.js.map

package/dist/pretty-widget.js.map

@@ -1 +1 @@
-{"version":3,"file":"pretty-widget.js","sourceRoot":"","sources":["../src/pretty-widget.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { sortStringsBy } from \"@gtkx/utils\";\nimport { formatRole } from \"./role-helpers.js\";\nimport { type Container, roots } from \"./traversal.js\";\nimport { getWidgetNodeText } from \"./widget-accessible-properties.js\";\n\nconst DEFAULT_MAX_LENGTH = 7000;\nconst INDENT = \"  \";\n\ntype WidgetIdResolver = (widget: Gtk.Widget) => string;\n\n/**\n * Options controlling how a widget tree is rendered to a string by\n * {@link prettyWidget} and {@link logWidget}.\n */\nexport type PrettyWidgetOptions = {\n    /** Truncates the output once it exceeds this many characters. */\n    maxLength?: number;\n    /** Whether to apply ANSI color highlighting; defaults to the terminal capabilities. */\n    highlight?: boolean;\n    /** Resolves an `id` attribute to show for each widget. */\n    getId?: WidgetIdResolver;\n};\n\nconst buildAttrs = (widget: Gtk.Widget, getId: WidgetIdResolver | undefined): [string, string][] => {\n    const attrs: [string, string][] = [];\n\n    if (getId) {\n        attrs.push([\"id\", getId(widget)]);\n    }\n\n    const name = widget.getName();\n    if (name) {\n        attrs.push([\"name\", name]);\n    }\n\n    attrs.push([\"role\", formatRole(widget.getAccessibleRole())]);\n\n    if (!widget.getSensitive()) {\n        attrs.push([\"accessible-disabled\", \"true\"]);\n    }\n\n    if (!widget.getVisible()) {\n        attrs.push([\"accessible-hidden\", \"true\"]);\n    }\n\n    const idAttrs = attrs.filter(([key]) => key === \"id\");\n    const otherAttrs = sortStringsBy(\n        attrs.filter(([key]) => key !== \"id\"),\n        ([key]) => key,\n    );\n    return [...idAttrs, ...otherAttrs];\n};\n\ntype Colors = {\n    tag: (s: string) => string;\n    attr: (s: string) => string;\n    value: (s: string) => string;\n};\n\nconst ansi = {\n    cyan: \"\\x1b[36m\",\n    yellow: \"\\x1b[33m\",\n    green: \"\\x1b[32m\",\n    reset: \"\\x1b[0m\",\n};\n\nconst shouldHighlight = (): boolean => {\n    if (typeof process === \"undefined\") return false;\n    if (process.env.COLORS === \"false\" || process.env.NO_COLOR) return false;\n    if (process.env.COLORS === \"true\" || process.env.FORCE_COLOR) return true;\n    return process.stdout.isTTY;\n};\n\nconst createColors = (enabled: boolean): Colors => {\n    if (!enabled) {\n        const identity = (s: string): string => s;\n        return { tag: identity, attr: identity, value: identity };\n    }\n    return {\n        tag: (s) => `${ansi.cyan}${s}${ansi.reset}`,\n        attr: (s) => `${ansi.yellow}${s}${ansi.reset}`,\n        value: (s) => `${ansi.green}${s}${ansi.reset}`,\n    };\n};\n\nconst escapeAttrValue = (value: string): string => value.replaceAll('\"', \"&quot;\");\n\nconst formatAttrs = (attrs: [string, string][], colors: Colors): string =>\n    attrs.map(([key, value]) => ` ${colors.attr(key)}=${colors.value(`\"${escapeAttrValue(value)}\"`)}`).join(\"\");\n\nconst formatWidget = (\n    widget: Gtk.Widget,\n    depth: number,\n    getId: WidgetIdResolver | undefined,\n    colors: Colors,\n): string => {\n    const indent = INDENT.repeat(depth);\n    const tag = widget.constructor.name;\n    const attrs = formatAttrs(buildAttrs(widget, getId), colors);\n    const openTag = `${colors.tag(\"<\")}${colors.tag(tag)}${attrs}${colors.tag(\">\")}`;\n    const closeTag = `${colors.tag(\"</\")}${colors.tag(tag)}${colors.tag(\">\")}`;\n\n    const text = getWidgetNodeText(widget);\n    const firstChild = widget.getFirstChild();\n\n    if (!text && !firstChild) {\n        return `${indent}${openTag}\\n`;\n    }\n\n    let output = `${indent}${openTag}\\n`;\n    if (text) {\n        output += `${indent}${INDENT}${text}\\n`;\n    }\n    let child = firstChild;\n    while (child) {\n        output += formatWidget(child, depth + 1, getId, colors);\n        child = child.getNextSibling();\n    }\n    output += `${indent}${closeTag}\\n`;\n    return output;\n};\n\n/**\n * Renders a widget tree as an indented, HTML-like string showing each widget's\n * tag, accessible attributes, and text content.\n *\n * @param container The scope whose widget tree is formatted.\n * @param options Formatting options such as truncation length and highlighting.\n * @returns The formatted representation of the tree.\n */\nexport const prettyWidget = (container: Container, options: PrettyWidgetOptions = {}): string => {\n    const envLimit = process.env.DEBUG_PRINT_LIMIT ? Number(process.env.DEBUG_PRINT_LIMIT) : DEFAULT_MAX_LENGTH;\n    const maxLength = options.maxLength ?? envLimit;\n\n    if (maxLength === 0) {\n        return \"\";\n    }\n\n    const highlight = options.highlight ?? shouldHighlight();\n    const colors = createColors(highlight);\n\n    let output = \"\";\n    for (const root of roots(container)) {\n        output += formatWidget(root, 0, options.getId, colors);\n    }\n\n    if (output.length > maxLength) {\n        return `${output.slice(0, maxLength)}...`;\n    }\n\n    return output.trimEnd();\n};\n\n/**\n * Prints one or more widget trees to the console using {@link prettyWidget}.\n *\n * @param container A single scope or an array of scopes to format and print.\n * @param options Formatting options passed through to {@link prettyWidget}.\n */\nexport const logWidget = (container: Container | Container[], options?: PrettyWidgetOptions): void => {\n    const containers: Container[] = Array.isArray(container) ? container : [container];\n    for (const target of containers) {\n        console.log(prettyWidget(target, options));\n    }\n};\n"]}
+{"version":3,"file":"pretty-widget.js","sourceRoot":"","sources":["../src/pretty-widget.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { sortStringsBy } from \"@gtkx/utils\";\nimport { formatRole } from \"./role-helpers.js\";\nimport { type Container, roots } from \"./traversal.js\";\nimport { getWidgetNodeText } from \"./widget-accessible-properties.js\";\n\ntype WidgetIdResolver = (widget: Gtk.Widget) => string;\n\n/**\n * Options controlling how a widget tree is rendered to a string by\n * {@link prettyWidget} and {@link logWidget}.\n */\ntype PrettyWidgetOptions = {\n    /** Truncates the output once it exceeds this many characters. */\n    maxLength?: number;\n    /** Whether to apply ANSI color highlighting; defaults to the terminal capabilities. */\n    highlight?: boolean;\n    /** Resolves an `id` attribute to show for each widget. */\n    getId?: WidgetIdResolver;\n    /** Stops descending past this depth, replacing deeper children with a summary line. */\n    maxDepth?: number;\n};\n\ntype Colors = {\n    tag: (s: string) => string;\n    attr: (s: string) => string;\n    value: (s: string) => string;\n};\n\ntype FormatContext = {\n    getId: WidgetIdResolver | undefined;\n    colors: Colors;\n    maxDepth: number | undefined;\n};\n\nconst DEFAULT_MAX_LENGTH = 7000;\nconst INDENT = \"  \";\n\nconst ansi = {\n    cyan: \"\\u{1B}[36m\",\n    yellow: \"\\u{1B}[33m\",\n    green: \"\\u{1B}[32m\",\n    reset: \"\\u{1B}[0m\",\n};\n\nconst buildAttrs = (widget: Gtk.Widget, getId: WidgetIdResolver | undefined): [string, string][] => {\n    const attrs: [string, string][] = [];\n\n    if (getId) {\n        attrs.push([\"id\", getId(widget)]);\n    }\n\n    const name = widget.getName();\n\n    if (name) {\n        attrs.push([\"name\", name]);\n    }\n\n    attrs.push([\"role\", formatRole(widget.getAccessibleRole())]);\n\n    if (!widget.getSensitive()) {\n        attrs.push([\"accessible-disabled\", \"true\"]);\n    }\n\n    if (!widget.getVisible()) {\n        attrs.push([\"accessible-hidden\", \"true\"]);\n    }\n\n    const idAttrs = attrs.filter(([key]) => key === \"id\");\n\n    const otherAttrs = sortStringsBy(\n        attrs.filter(([key]) => key !== \"id\"),\n        ([key]) => key,\n    );\n\n    return [...idAttrs, ...otherAttrs];\n};\n\nconst shouldHighlight = (): boolean => {\n    if (typeof process === \"undefined\") {\n        return false;\n    }\n\n    if (process.env.COLORS === \"false\" || process.env.NO_COLOR) {\n        return false;\n    }\n\n    if (process.env.COLORS === \"true\" || process.env.FORCE_COLOR) {\n        return true;\n    }\n\n    return process.stdout.isTTY;\n};\n\nconst createColors = (isEnabled: boolean): Colors => {\n    if (!isEnabled) {\n        const identity = (s: string): string => s;\n\n        return { tag: identity, attr: identity, value: identity };\n    }\n\n    return {\n        tag: (s) => `${ansi.cyan}${s}${ansi.reset}`,\n        attr: (s) => `${ansi.yellow}${s}${ansi.reset}`,\n        value: (s) => `${ansi.green}${s}${ansi.reset}`,\n    };\n};\n\nconst escapeAttrValue = (value: string): string => value.replaceAll('\"', \"&quot;\");\n\nconst formatAttr = (key: string, value: string, colors: Colors): string => {\n    const quoted = `\"${escapeAttrValue(value)}\"`;\n\n    return ` ${colors.attr(key)}=${colors.value(quoted)}`;\n};\n\nconst formatAttrs = (attrs: [string, string][], colors: Colors): string =>\n    attrs.map(([key, value]) => formatAttr(key, value, colors)).join(\"\");\n\nconst countChildren = (widget: Gtk.Widget): number => {\n    let count = 0;\n    let child = widget.getFirstChild();\n\n    while (child) {\n        count += 1;\n        child = child.getNextSibling();\n    }\n\n    return count;\n};\n\nconst formatHiddenChildrenLine = (widget: Gtk.Widget, depth: number, ctx: FormatContext): string => {\n    const { getId, colors } = ctx;\n    const indent = INDENT.repeat(depth);\n    const count = countChildren(widget);\n    const hint = getId ? ` (pass rootId=\"${getId(widget)}\" or raise maxDepth to expand)` : \"\";\n    const plural = count === 1 ? \"\" : \"s\";\n    const summary = `… ${String(count)} child widget${plural} hidden${hint}`;\n\n    return `${indent}${INDENT}${colors.tag(summary)}\\n`;\n};\n\nconst formatChildren = (widget: Gtk.Widget, depth: number, ctx: FormatContext): string => {\n    let output = \"\";\n    let child = widget.getFirstChild();\n\n    while (child) {\n        output += formatWidget(child, depth + 1, ctx);\n        child = child.getNextSibling();\n    }\n\n    return output;\n};\n\nconst formatWidget = (widget: Gtk.Widget, depth: number, ctx: FormatContext): string => {\n    const { getId, colors, maxDepth } = ctx;\n    const indent = INDENT.repeat(depth);\n    const tag = widget.constructor.name;\n    const attrs = formatAttrs(buildAttrs(widget, getId), colors);\n    const openTag = `${colors.tag(\"<\")}${colors.tag(tag)}${attrs}${colors.tag(\">\")}`;\n    const closeTag = `${colors.tag(\"</\")}${colors.tag(tag)}${colors.tag(\">\")}`;\n    const text = getWidgetNodeText(widget);\n    const firstChild = widget.getFirstChild();\n\n    if (!text && !firstChild) {\n        return `${indent}${openTag}\\n`;\n    }\n\n    let output = `${indent}${openTag}\\n`;\n\n    if (text) {\n        output += `${indent}${INDENT}${text}\\n`;\n    }\n\n    if (firstChild && maxDepth !== undefined && depth >= maxDepth) {\n        output += formatHiddenChildrenLine(widget, depth, ctx);\n        output += `${indent}${closeTag}\\n`;\n\n        return output;\n    }\n\n    output += formatChildren(widget, depth, ctx);\n    output += `${indent}${closeTag}\\n`;\n\n    return output;\n};\n\nconst resolveMaxLength = (options: PrettyWidgetOptions): number => {\n    const envLimit = process.env.DEBUG_PRINT_LIMIT ? Number(process.env.DEBUG_PRINT_LIMIT) : DEFAULT_MAX_LENGTH;\n\n    return options.maxLength ?? envLimit;\n};\n\n/**\n * Renders a widget tree as an indented, HTML-like string showing each widget's\n * tag, accessible attributes, and text content.\n *\n * @param container The scope whose widget tree is formatted.\n * @param options Formatting options such as truncation length and highlighting.\n * @returns The formatted representation of the tree.\n */\nconst prettyWidget = (container: Container, options: PrettyWidgetOptions = {}): string => {\n    const maxLength = resolveMaxLength(options);\n\n    if (maxLength === 0) {\n        return \"\";\n    }\n\n    const isHighlight = options.highlight ?? shouldHighlight();\n    const colors = createColors(isHighlight);\n    let output = \"\";\n\n    for (const root of roots(container)) {\n        output += formatWidget(root, 0, { getId: options.getId, colors, maxDepth: options.maxDepth });\n    }\n\n    if (output.length > maxLength) {\n        return `${output.slice(0, maxLength)}...`;\n    }\n\n    return output.trimEnd();\n};\n\n/**\n * Prints one or more widget trees to the console using {@link prettyWidget}.\n *\n * @param container A single scope or an array of scopes to format and print.\n * @param options Formatting options passed through to {@link prettyWidget}.\n */\nconst logWidget = (container: Container | Container[], options?: PrettyWidgetOptions): void => {\n    const containers: Container[] = Array.isArray(container) ? container : [container];\n\n    for (const target of containers) {\n        console.log(prettyWidget(target, options));\n    }\n};\n\nexport { prettyWidget, logWidget, type PrettyWidgetOptions };\n"]}