browser-debugger-cli 0.10.0 → 0.12.0

package/dist/errors/messages.d.ts

@@ -691,7 +691,16 @@ export declare function elementNotVisibleError(): ErrorWithSuggestion;
  */
 export declare function elementZeroDimensionsError(): ErrorWithSuggestion;
 /**
- * Missing required argument.
+ * `bdg dom hover --off` was given an element too.
+ *
+ * @returns Message and suggestion
+ */
+export declare function hoverOffWithTargetError(): ErrorWithSuggestion;
+/**
+ * A command was given neither its argument nor a flag that replaces it.
+ *
+ * @param usage - How to call it
+ * @returns Message and suggestion
  */
 export declare function missingArgumentError(usage: string): ErrorWithSuggestion;
 /**
@@ -927,10 +936,16 @@ export declare function unexpectedResponseFormatError(context: string): ErrorWit
  */
 export declare function operationFailedError(operation: string, errorMessage: string): ErrorWithSuggestion;
 /**
- * `dom inspect --props` named a property the element has no value for.
+ * `--why all`: `all` resets every property, so there is no one cascade to show.
  *
- * @param names - Unknown property names
- * @param suggestions - Similar computed property names
+ * @returns Message and suggestion
+ */
+export declare function whyAllPropertyError(): ErrorWithSuggestion;
+/**
+ * Names given to --props or --why that are not CSS properties.
+ *
+ * @param names - Unknown names
+ * @param suggestions - Closest known names
  * @returns Message and suggestion
  */
 export declare function unknownCssPropertyError(names: string[], suggestions: string[]): ErrorWithSuggestion;
@@ -973,5 +988,36 @@ export declare function formInIframeError(iframeUrl: string, crossOrigin: boolea
 export declare function cdpCallError(method: string, message: string): ErrorWithSuggestion & {
     notFound: boolean;
 };
+/**
+ * The skill file is not where the package should have it (a broken or
+ * partial install).
+ *
+ * @param source - Expected SKILL.md path
+ * @returns Message and suggestion
+ */
+export declare function skillSourceMissingError(source: string): ErrorWithSuggestion;
+/**
+ * The skill could not be written to an agent's skill directory.
+ *
+ * @param path - Destination SKILL.md
+ * @param reason - The file system error
+ * @returns Message and suggestion
+ */
+export declare function skillWriteFailedError(path: string, reason: string): ErrorWithSuggestion;
+/**
+ * `bdg peek --interval` without `--follow`.
+ *
+ * @returns Message and suggestion
+ */
+export declare function intervalWithoutFollowError(): ErrorWithSuggestion;
+/**
+ * An unknown `dom audit` check.
+ *
+ * @param value - Name given
+ * @param similar - Closest names
+ * @param checks - Every check
+ * @returns Message
+ */
+export declare function unknownAuditCheckMessage(value: string, similar: string[], checks: readonly string[]): string;
 export {};
 //# sourceMappingURL=messages.d.ts.map

package/dist/errors/messages.js

@@ -1025,9 +1025,25 @@ export function noNodesFoundError(selector, context = {}) {
     const note = unreachableElementsNote(selector, context.unsearched);
     return {
         message: `No nodes found matching "${selector}"`,
-        suggestion: withLoadingHint(joinLines(context.similar, context.shadowHost && shadowBoundaryLine(context.shadowHost), `${hidden}Verify the CSS selector is correct.`, note ? note : undefined), context.readyState, selector),
+        suggestion: withLoadingHint(joinLines(context.similar, context.shadowHost && shadowBoundaryLine(context.shadowHost), shadowPseudoLine(selector), `${hidden}Verify the CSS selector is correct.`, note ? note : undefined), context.readyState, selector),
     };
 }
+/**
+ * Advice for a selector with `::part()` or `::slotted()`, which name
+ * pseudo-elements a page's stylesheet uses and never match an element.
+ *
+ * @param selector - Selector as given
+ * @returns Line, or undefined for other selectors
+ */
+function shadowPseudoLine(selector) {
+    const part = /::part\(\s*([^)\s]+)\s*\)/.exec(selector)?.[1];
+    if (part) {
+        return `::part() styles a shadow part and selects nothing; bdg searches open shadow roots, so select the part itself: [part~="${part}"]`;
+    }
+    return /::slotted\(/.test(selector)
+        ? '::slotted() selects nothing; select the slotted element itself (it is in the light DOM)'
+        : undefined;
+}
 /**
  * Quote a value for a POSIX shell command line.
  *
@@ -1176,7 +1192,21 @@ export function elementZeroDimensionsError() {
     };
 }
 /**
- * Missing required argument.
+ * `bdg dom hover --off` was given an element too.
+ *
+ * @returns Message and suggestion
+ */
+export function hoverOffWithTargetError() {
+    return {
+        message: '--off moves the mouse off the page; it takes no element',
+        suggestion: 'Use bdg dom hover --off alone, or bdg dom hover <selector> to hover an element',
+    };
+}
+/**
+ * A command was given neither its argument nor a flag that replaces it.
+ *
+ * @param usage - How to call it
+ * @returns Message and suggestion
  */
 export function missingArgumentError(usage) {
     return {
@@ -1644,10 +1674,21 @@ export function operationFailedError(operation, errorMessage) {
     };
 }
 /**
- * `dom inspect --props` named a property the element has no value for.
+ * `--why all`: `all` resets every property, so there is no one cascade to show.
+ *
+ * @returns Message and suggestion
+ */
+export function whyAllPropertyError() {
+    return {
+        message: '--why takes one property; "all" resets every property',
+        suggestion: 'Name the property you are after (e.g. --why color), or use --all to list the set ones',
+    };
+}
+/**
+ * Names given to --props or --why that are not CSS properties.
  *
- * @param names - Unknown property names
- * @param suggestions - Similar computed property names
+ * @param names - Unknown names
+ * @param suggestions - Closest known names
  * @returns Message and suggestion
  */
 export function unknownCssPropertyError(names, suggestions) {
@@ -1751,4 +1792,52 @@ export function cdpCallError(method, message) {
         notFound: false,
     };
 }
+/**
+ * The skill file is not where the package should have it (a broken or
+ * partial install).
+ *
+ * @param source - Expected SKILL.md path
+ * @returns Message and suggestion
+ */
+export function skillSourceMissingError(source) {
+    return {
+        message: `The bdg skill is missing from the installed package (${source})`,
+        suggestion: 'Reinstall bdg: npm install -g browser-debugger-cli',
+    };
+}
+/**
+ * The skill could not be written to an agent's skill directory.
+ *
+ * @param path - Destination SKILL.md
+ * @param reason - The file system error
+ * @returns Message and suggestion
+ */
+export function skillWriteFailedError(path, reason) {
+    return {
+        message: `Could not write ${path}: ${reason}`,
+        suggestion: 'Check the permissions of that directory, or install for the other agent only (--claude or --agents)',
+    };
+}
+/**
+ * `bdg peek --interval` without `--follow`.
+ *
+ * @returns Message and suggestion
+ */
+export function intervalWithoutFollowError() {
+    return {
+        message: '--interval sets how often --follow refreshes',
+        suggestion: 'Add --follow, e.g. bdg peek --follow --interval 500',
+    };
+}
+/**
+ * An unknown `dom audit` check.
+ *
+ * @param value - Name given
+ * @param similar - Closest names
+ * @param checks - Every check
+ * @returns Message
+ */
+export function unknownAuditCheckMessage(value, similar, checks) {
+    return `Unknown check "${value}"${similar.length > 0 ? `; did you mean ${similar[0]}?` : ''} (checks: ${checks.join(', ')})`;
+}
 //# sourceMappingURL=messages.js.map