browser-debugger-cli 0.6.7 → 0.6.9

package/dist/telemetry/objectExpander.js

@@ -0,0 +1,165 @@
+/**
+ * Object expansion utilities for CDP RemoteObjects.
+ *
+ * Fetches nested object properties using Runtime.getProperties to provide
+ * rich object representations beyond CDP's default shallow preview.
+ */
+import { OBJECT_EXPANSION_MAX_DEPTH, OBJECT_EXPANSION_MAX_PROPERTIES, OBJECT_EXPANSION_FAILURE_THRESHOLD, } from '../constants.js';
+import { createLogger } from '../ui/logging/index.js';
+import { isPrimitiveObject, hasSpecialDescription, getFallbackDescription, formatPrimitiveValue, } from './remoteObjectUtils.js';
+const log = createLogger('object-expander');
+let consecutiveFailures = 0;
+/**
+ * Reset the failure counter (useful for testing).
+ */
+export function resetFailureCounter() {
+    consecutiveFailures = 0;
+}
+/**
+ * Record an expansion failure and log warning if threshold exceeded.
+ */
+function recordFailure(error) {
+    consecutiveFailures++;
+    if (consecutiveFailures === OBJECT_EXPANSION_FAILURE_THRESHOLD) {
+        log.info(`Object expansion failed ${OBJECT_EXPANSION_FAILURE_THRESHOLD} times consecutively. ` +
+            `CDP connection may be unstable. Last error: ${String(error)}`);
+    }
+    else {
+        log.debug(`Failed to expand object: ${String(error)}`);
+    }
+}
+/**
+ * Record a successful expansion (resets failure counter).
+ */
+function recordSuccess() {
+    consecutiveFailures = 0;
+}
+/**
+ * Format a primitive RemoteObject value for expansion output.
+ * Quotes strings to distinguish them from other values in object context.
+ */
+function formatExpandedPrimitive(arg) {
+    if (arg.value !== undefined) {
+        if (typeof arg.value === 'string') {
+            return `"${arg.value}"`;
+        }
+        return formatPrimitiveValue(arg.value);
+    }
+    return 'undefined';
+}
+/**
+ * Fetch object properties from CDP.
+ */
+async function fetchProperties(cdp, objectId) {
+    const response = await cdp.send('Runtime.getProperties', {
+        objectId,
+        ownProperties: true,
+        generatePreview: true,
+    });
+    const result = response;
+    return result.result ?? [];
+}
+/**
+ * Filter properties to enumerable ones with values.
+ */
+function getEnumerableProperties(properties) {
+    return properties
+        .filter((p) => p.enumerable && p.value)
+        .slice(0, OBJECT_EXPANSION_MAX_PROPERTIES);
+}
+/**
+ * Check if property count exceeds limit.
+ */
+function hasOverflow(properties, filterFn) {
+    return properties.filter(filterFn).length > OBJECT_EXPANSION_MAX_PROPERTIES;
+}
+/**
+ * Format array items from properties.
+ */
+async function formatArrayItems(cdp, properties, depth) {
+    const items = [];
+    const ownProps = getEnumerableProperties(properties);
+    for (const prop of ownProps) {
+        if (!isNaN(Number(prop.name)) && prop.value) {
+            const formatted = await expandRemoteObject(cdp, prop.value, depth + 1);
+            items.push(formatted);
+        }
+    }
+    return items;
+}
+/**
+ * Format object pairs from properties.
+ */
+async function formatObjectPairs(cdp, properties, depth) {
+    const pairs = [];
+    const ownProps = getEnumerableProperties(properties);
+    for (const prop of ownProps) {
+        if (prop.value) {
+            const formatted = await expandRemoteObject(cdp, prop.value, depth + 1);
+            pairs.push(`${prop.name}: ${formatted}`);
+        }
+    }
+    return pairs;
+}
+/**
+ * Format an array RemoteObject.
+ */
+async function formatArray(cdp, properties, depth) {
+    const items = await formatArrayItems(cdp, properties, depth);
+    const overflow = hasOverflow(properties, (p) => !isNaN(Number(p.name)));
+    return `[${items.join(', ')}${overflow ? ', …' : ''}]`;
+}
+/**
+ * Format a regular object RemoteObject.
+ */
+async function formatObject(cdp, properties, depth) {
+    const pairs = await formatObjectPairs(cdp, properties, depth);
+    const overflow = hasOverflow(properties, (p) => p.enumerable === true);
+    return `{${pairs.join(', ')}${overflow ? ', …' : ''}}`;
+}
+/**
+ * Expand a RemoteObject to get nested property values.
+ *
+ * Recursively fetches properties up to MAX_DEPTH levels deep,
+ * providing rich object representation for console output.
+ *
+ * @param cdp - CDP connection for property fetching
+ * @param arg - RemoteObject to expand
+ * @param depth - Current recursion depth
+ * @returns Formatted string representation with expanded properties
+ */
+export async function expandRemoteObject(cdp, arg, depth = 0) {
+    if (isPrimitiveObject(arg)) {
+        return formatExpandedPrimitive(arg);
+    }
+    if (hasSpecialDescription(arg)) {
+        return arg.description ?? getFallbackDescription(arg);
+    }
+    if (!arg.objectId || depth >= OBJECT_EXPANSION_MAX_DEPTH) {
+        return getFallbackDescription(arg);
+    }
+    try {
+        const properties = await fetchProperties(cdp, arg.objectId);
+        recordSuccess();
+        if (arg.subtype === 'array') {
+            return await formatArray(cdp, properties, depth);
+        }
+        return await formatObject(cdp, properties, depth);
+    }
+    catch (error) {
+        recordFailure(error);
+        return getFallbackDescription(arg);
+    }
+}
+/**
+ * Expand multiple RemoteObjects and format as console message text.
+ *
+ * @param cdp - CDP connection for property fetching
+ * @param args - Array of RemoteObjects to expand
+ * @returns Formatted string with expanded objects
+ */
+export async function expandConsoleArgs(cdp, args) {
+    const expanded = await Promise.all(args.map((arg) => expandRemoteObject(cdp, arg)));
+    return expanded.join(' ');
+}
+//# sourceMappingURL=objectExpander.js.map

package/dist/telemetry/objectExpander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectExpander.js","sourceRoot":"","sources":["../../src/telemetry/objectExpander.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/remoteObject.d.ts

@@ -0,0 +1,41 @@
+/**
+ * RemoteObject formatting utilities.
+ *
+ * Provides functions to serialize CDP RemoteObject values into human-readable
+ * strings, properly handling objects, arrays, and their preview data with
+ * recursive nested object expansion.
+ */
+import type { Protocol } from '../connection/typed-cdp.js';
+type RemoteObject = Protocol.Runtime.RemoteObject;
+/**
+ * Format a CDP RemoteObject as a human-readable string.
+ *
+ * Handles all CDP value types including primitives, objects, arrays,
+ * errors, null, and undefined. Uses preview data when available for
+ * rich object representation with recursive nested object expansion.
+ *
+ * @param arg - CDP RemoteObject from console arguments
+ * @returns Formatted string representation
+ *
+ * @example
+ * ```typescript
+ * formatRemoteObject({ type: 'string', value: 'hello' }) // 'hello'
+ * formatRemoteObject({
+ *   type: 'object',
+ *   preview: { properties: [{ name: 'foo', value: 'bar' }] }
+ * }) // '{foo: "bar"}'
+ * ```
+ */
+export declare function formatRemoteObject(arg: RemoteObject): string;
+/**
+ * Format multiple RemoteObjects as console message text.
+ *
+ * Joins formatted arguments with spaces, similar to how console.log
+ * displays multiple arguments.
+ *
+ * @param args - Array of CDP RemoteObjects
+ * @returns Joined formatted string
+ */
+export declare function formatConsoleArgs(args: RemoteObject[]): string;
+export {};
+//# sourceMappingURL=remoteObject.d.ts.map

package/dist/telemetry/remoteObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteObject.d.ts","sourceRoot":"","sources":["../../src/telemetry/remoteObject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAU1D,KAAK,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;AA6JlD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAkB5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,CAE9D"}

package/dist/telemetry/remoteObject.js

@@ -0,0 +1,193 @@
+/**
+ * RemoteObject formatting utilities.
+ *
+ * Provides functions to serialize CDP RemoteObject values into human-readable
+ * strings, properly handling objects, arrays, and their preview data with
+ * recursive nested object expansion.
+ */
+import { SPECIAL_DESCRIPTION_SUBTYPES, formatPrimitiveValue, getFallbackDescription, } from './remoteObjectUtils.js';
+/**
+ * Check if a property represents a null value.
+ */
+function isNullProperty(prop) {
+    return prop.subtype === 'null' || prop.value === 'null';
+}
+/**
+ * Check if a property has a special subtype with meaningful string representation.
+ */
+function hasSpecialSubtype(prop) {
+    return prop.subtype === 'date' || prop.subtype === 'regexp';
+}
+/**
+ * Format a primitive property value.
+ */
+function formatPrimitiveProperty(prop) {
+    if (prop.type === 'string') {
+        return `"${prop.value}"`;
+    }
+    if (prop.type === 'undefined') {
+        return 'undefined';
+    }
+    if (prop.type === 'symbol') {
+        return prop.value ?? 'Symbol()';
+    }
+    if (prop.type === 'function') {
+        return prop.value ?? '[Function]';
+    }
+    return prop.value ?? prop.type;
+}
+/**
+ * Format a preview property value, recursively handling nested objects.
+ *
+ * @param prop - Preview property from CDP
+ * @returns Formatted value string
+ */
+function formatPreviewProperty(prop) {
+    if (prop.valuePreview) {
+        return formatObjectPreview(prop.valuePreview);
+    }
+    if (isNullProperty(prop)) {
+        return 'null';
+    }
+    if (hasSpecialSubtype(prop)) {
+        return prop.value ?? `[${prop.subtype}]`;
+    }
+    return formatPrimitiveProperty(prop);
+}
+/**
+ * Format an entry value from Map/Set preview.
+ *
+ * @param value - Entry preview value
+ * @returns Formatted value string
+ */
+function formatEntryValue(value) {
+    if (value.type === 'string') {
+        return `"${value.description ?? ''}"`;
+    }
+    if (value.type === 'object' && value.properties) {
+        return formatObjectPreview(value);
+    }
+    return value.description ?? value.type;
+}
+/**
+ * Extract size from description string like "Map(3)" or "Set(5)".
+ */
+function extractSizeFromDescription(description) {
+    return description?.match(/\d+/)?.[0] ?? '0';
+}
+/**
+ * Format a Map preview.
+ */
+function formatMapPreview(preview, suffix) {
+    const entries = preview.entries ?? [];
+    if (entries.length === 0) {
+        return `Map(${extractSizeFromDescription(preview.description)})`;
+    }
+    const formattedEntries = entries.map((e) => {
+        const key = e.key ? formatEntryValue(e.key) : '?';
+        const value = formatEntryValue(e.value);
+        return `${key} => ${value}`;
+    });
+    return `Map(${entries.length}) {${formattedEntries.join(', ')}${suffix}}`;
+}
+/**
+ * Format a Set preview.
+ */
+function formatSetPreview(preview, suffix) {
+    const entries = preview.entries ?? [];
+    if (entries.length === 0) {
+        return `Set(${extractSizeFromDescription(preview.description)})`;
+    }
+    const formattedEntries = entries.map((e) => formatEntryValue(e.value));
+    return `Set(${entries.length}) {${formattedEntries.join(', ')}${suffix}}`;
+}
+/**
+ * Format an array preview.
+ */
+function formatArrayPreview(props, suffix) {
+    const values = props
+        .filter((p) => !isNaN(Number(p.name)))
+        .sort((a, b) => Number(a.name) - Number(b.name))
+        .map(formatPreviewProperty);
+    return `[${values.join(', ')}${suffix}]`;
+}
+/**
+ * Format a regular object preview.
+ */
+function formatRegularObjectPreview(props, suffix) {
+    const pairs = props.map((p) => `${p.name}: ${formatPreviewProperty(p)}`);
+    return `{${pairs.join(', ')}${suffix}}`;
+}
+/**
+ * Format object preview as a string representation.
+ *
+ * Recursively formats nested objects using their valuePreview data,
+ * matching Chrome DevTools console output format.
+ *
+ * @param preview - Object preview from CDP RemoteObject
+ * @returns Formatted object string like `{foo: "bar", num: 123}`
+ */
+function formatObjectPreview(preview) {
+    const props = preview.properties ?? [];
+    const suffix = preview.overflow ? ', …' : '';
+    if (SPECIAL_DESCRIPTION_SUBTYPES.has(preview.subtype ?? '')) {
+        return preview.description ?? `[${preview.subtype}]`;
+    }
+    if (preview.subtype === 'map') {
+        return formatMapPreview(preview, suffix);
+    }
+    if (preview.subtype === 'set') {
+        return formatSetPreview(preview, suffix);
+    }
+    if (preview.subtype === 'array') {
+        return formatArrayPreview(props, suffix);
+    }
+    return formatRegularObjectPreview(props, suffix);
+}
+/**
+ * Format a CDP RemoteObject as a human-readable string.
+ *
+ * Handles all CDP value types including primitives, objects, arrays,
+ * errors, null, and undefined. Uses preview data when available for
+ * rich object representation with recursive nested object expansion.
+ *
+ * @param arg - CDP RemoteObject from console arguments
+ * @returns Formatted string representation
+ *
+ * @example
+ * ```typescript
+ * formatRemoteObject({ type: 'string', value: 'hello' }) // 'hello'
+ * formatRemoteObject({
+ *   type: 'object',
+ *   preview: { properties: [{ name: 'foo', value: 'bar' }] }
+ * }) // '{foo: "bar"}'
+ * ```
+ */
+export function formatRemoteObject(arg) {
+    if (arg.value !== undefined) {
+        return formatPrimitiveValue(arg.value);
+    }
+    if (arg.type === 'undefined') {
+        return 'undefined';
+    }
+    if (arg.subtype === 'error' && arg.description) {
+        return arg.description;
+    }
+    if (arg.type === 'object' && arg.preview) {
+        return formatObjectPreview(arg.preview);
+    }
+    return getFallbackDescription(arg);
+}
+/**
+ * Format multiple RemoteObjects as console message text.
+ *
+ * Joins formatted arguments with spaces, similar to how console.log
+ * displays multiple arguments.
+ *
+ * @param args - Array of CDP RemoteObjects
+ * @returns Joined formatted string
+ */
+export function formatConsoleArgs(args) {
+    return args.map(formatRemoteObject).join(' ');
+}
+//# sourceMappingURL=remoteObject.js.map

package/dist/telemetry/remoteObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteObject.js","sourceRoot":"","sources":["../../src/telemetry/remoteObject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAMhC;;GAEG;AACH,SAAS,cAAc,CAAC,IAAqB;IAC3C,OAAO,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAqB;IAC9C,OAAO,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,IAAqB;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC;IAClC,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,IAAqB;IAClD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;IAC3C,CAAC;IAED,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,GAAG,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAChD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,WAA+B;IACjE,OAAO,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAsB,EAAE,MAAc;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,0BAA0B,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC;IACnE,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,GAAG,GAAG,OAAO,KAAK,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,OAAO,CAAC,MAAM,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAsB,EAAE,MAAc;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,0BAA0B,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC;IACnE,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,OAAO,OAAO,OAAO,CAAC,MAAM,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAwB,EAAE,MAAc;IAClE,MAAM,MAAM,GAAG,KAAK;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC/C,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC9B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,KAAwB,EAAE,MAAc;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,mBAAmB,CAAC,OAAsB;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7C,IAAI,4BAA4B,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,OAAO,OAAO,CAAC,WAAW,IAAI,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,0BAA0B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAiB;IAClD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QAC/C,OAAO,GAAG,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACzC,OAAO,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAoB;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/telemetry/remoteObjectUtils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared utilities for RemoteObject type checking and formatting.
+ *
+ * Provides common predicates and formatters used by both synchronous
+ * preview-based formatting and asynchronous CDP-based expansion.
+ */
+import type { Protocol } from '../connection/typed-cdp.js';
+type RemoteObject = Protocol.Runtime.RemoteObject;
+/**
+ * Subtypes that have meaningful description strings from CDP.
+ */
+export declare const SPECIAL_DESCRIPTION_SUBTYPES: Set<string>;
+/**
+ * Check if a RemoteObject is a primitive that can be formatted directly.
+ */
+export declare function isPrimitiveObject(arg: RemoteObject): boolean;
+/**
+ * Check if a RemoteObject has a special subtype with meaningful description.
+ */
+export declare function hasSpecialDescription(arg: RemoteObject): boolean;
+/**
+ * Get fallback string representation for a RemoteObject.
+ */
+export declare function getFallbackDescription(arg: RemoteObject): string;
+/**
+ * Format a primitive value consistently across sync and async paths.
+ * Note: String primitives in console output are NOT quoted (matches Chrome DevTools behavior).
+ */
+export declare function formatPrimitiveValue(value: unknown): string;
+/**
+ * Check if preview data is fully expanded (not truncated and no shallow nested objects).
+ */
+export declare function isPreviewFullyExpanded(arg: RemoteObject): boolean;
+/**
+ * Check if an object needs async expansion.
+ * Expand if: has objectId, is not null, and preview is missing, truncated, or has unexpanded nested objects.
+ */
+export declare function needsAsyncExpansion(arg: RemoteObject): boolean;
+export {};
+//# sourceMappingURL=remoteObjectUtils.d.ts.map

package/dist/telemetry/remoteObjectUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteObjectUtils.d.ts","sourceRoot":"","sources":["../../src/telemetry/remoteObjectUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,KAAK,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,4BAA4B,aAAkD,CAAC;AAE5F;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW3D;AAWD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAQjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAK9D"}

package/dist/telemetry/remoteObjectUtils.js

@@ -0,0 +1,75 @@
+/**
+ * Shared utilities for RemoteObject type checking and formatting.
+ *
+ * Provides common predicates and formatters used by both synchronous
+ * preview-based formatting and asynchronous CDP-based expansion.
+ */
+/**
+ * Subtypes that have meaningful description strings from CDP.
+ */
+export const SPECIAL_DESCRIPTION_SUBTYPES = new Set(['date', 'regexp', 'error', 'promise']);
+/**
+ * Check if a RemoteObject is a primitive that can be formatted directly.
+ */
+export function isPrimitiveObject(arg) {
+    return arg.value !== undefined || arg.type === 'undefined';
+}
+/**
+ * Check if a RemoteObject has a special subtype with meaningful description.
+ */
+export function hasSpecialDescription(arg) {
+    return SPECIAL_DESCRIPTION_SUBTYPES.has(arg.subtype ?? '') && arg.description !== undefined;
+}
+/**
+ * Get fallback string representation for a RemoteObject.
+ */
+export function getFallbackDescription(arg) {
+    return arg.description ?? `[${arg.type}]`;
+}
+/**
+ * Format a primitive value consistently across sync and async paths.
+ * Note: String primitives in console output are NOT quoted (matches Chrome DevTools behavior).
+ */
+export function formatPrimitiveValue(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (value === null) {
+        return 'null';
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Check if a preview property has unexpanded nested objects.
+ * CDP shows nested objects as just "Object" without valuePreview.
+ */
+function hasUnexpandedNestedObjects(preview) {
+    const props = preview.properties ?? [];
+    return props.some((p) => p.type === 'object' && !p.valuePreview && p.value === 'Object');
+}
+/**
+ * Check if preview data is fully expanded (not truncated and no shallow nested objects).
+ */
+export function isPreviewFullyExpanded(arg) {
+    if (!arg.preview) {
+        return false;
+    }
+    if (arg.preview.overflow) {
+        return false;
+    }
+    return !hasUnexpandedNestedObjects(arg.preview);
+}
+/**
+ * Check if an object needs async expansion.
+ * Expand if: has objectId, is not null, and preview is missing, truncated, or has unexpanded nested objects.
+ */
+export function needsAsyncExpansion(arg) {
+    if (arg.type !== 'object' || !arg.objectId || arg.subtype === 'null') {
+        return false;
+    }
+    return !isPreviewFullyExpanded(arg);
+}
+//# sourceMappingURL=remoteObjectUtils.js.map

package/dist/telemetry/remoteObjectUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteObjectUtils.js","sourceRoot":"","sources":["../../src/telemetry/remoteObjectUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAiB;IACrD,OAAO,4BAA4B,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC;AAC9F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAiB;IACtD,OAAO,GAAG,CAAC,WAAW,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CAAC,OAAuC;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAiB;IACtD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/telemetry/roleInference.d.ts

@@ -6,7 +6,7 @@
  *
  * @see https://www.w3.org/TR/html-aria/#docconformance
  */
-import type { DomContext } from '../types/dom.js';
+import type { DomContext } from '../types.js';
 import type { A11yNode } from '../types.js';
 /**
  * Infers an ARIA role from an HTML tag name.

package/dist/telemetry/roleInference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roleInference.d.ts","sourceRoot":"","sources":["../../src/telemetry/roleInference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAwF3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CA0BnF"}
+{"version":3,"file":"roleInference.d.ts","sourceRoot":"","sources":["../../src/telemetry/roleInference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAwF3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CA0BnF"}