browser-debugger-cli 0.6.10 → 0.7.0

package/dist/ui/messages/errors.d.ts

@@ -100,22 +100,134 @@ export declare function invalidResponseError(reason: string): string;
  */
 export declare function sessionNotActiveError(operation: string): string;
 /**
- * Generate element not found error with CDP fallback.
+ * Generate element not found error with shell quote detection and CDP fallback.
  *
- * Provides guidance for when high-level DOM commands fail to find elements,
- * including CDP alternatives for complex queries.
+ * Provides guidance for when high-level DOM commands fail to find elements.
+ * Detects shell quote damage for attribute selectors and provides specific
+ * recovery suggestions including the two-step query-then-inspect pattern.
  *
- * @param selector - CSS selector that failed
- * @returns Formatted error message with fallback suggestions
+ * @param selector - CSS selector that failed (as received by the command)
+ * @returns Formatted error message with context-aware suggestions
  *
  * @example
  * ```typescript
- * throw new CommandError(
- *   elementNotFoundError('#missing-element'),
- *   { cdpAlternative: 'Use Runtime.evaluate for complex queries' },
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
+ * // Simple selector - standard suggestions
+ * elementNotFoundError('#missing-element')
+ *
+ * // Attribute selector with shell damage detected
+ * elementNotFoundError('[data-test-id=value]')
+ * // Shows: "Shell quote handling detected. Selector received without quotes."
  * ```
  */
 export declare function elementNotFoundError(selector: string): string;
+/**
+ * Error with suggestion pair for CommandError usage.
+ */
+export interface ErrorWithSuggestion {
+    message: string;
+    suggestion: string;
+}
+/**
+ * Index out of range error.
+ */
+export declare function indexOutOfRangeError(index: number, max: number): ErrorWithSuggestion;
+/**
+ * Element at index not found (stale cache).
+ */
+export declare function elementAtIndexNotFoundError(index: number, selector: string): ErrorWithSuggestion;
+/**
+ * No nodes found for selector.
+ */
+export declare function noNodesFoundError(selector: string): ErrorWithSuggestion;
+/**
+ * Element not visible/rendered.
+ */
+export declare function elementNotVisibleError(): ErrorWithSuggestion;
+/**
+ * Element has zero dimensions.
+ */
+export declare function elementZeroDimensionsError(): ErrorWithSuggestion;
+/**
+ * Missing required argument.
+ */
+export declare function missingArgumentError(usage: string): ErrorWithSuggestion;
+/**
+ * Either/or argument required.
+ */
+export declare function eitherArgumentRequiredError(arg1: string, arg2: string, example: string): ErrorWithSuggestion;
+/**
+ * Invalid query pattern.
+ */
+export declare function invalidQueryPatternError(pattern: string): ErrorWithSuggestion;
+/**
+ * No a11y nodes matching pattern.
+ */
+export declare function noA11yNodesFoundError(pattern: string): ErrorWithSuggestion;
+/**
+ * Element not accessible (a11y).
+ */
+export declare function elementNotAccessibleError(index: number): ErrorWithSuggestion;
+/**
+ * Fillable element not found.
+ */
+export declare function fillableElementNotFoundError(selector: string): ErrorWithSuggestion;
+/**
+ * Clickable element not found.
+ */
+export declare function clickableElementNotFoundError(selector: string): ErrorWithSuggestion;
+/**
+ * Key press failed.
+ */
+export declare function keyPressFailedError(details: string): ErrorWithSuggestion;
+/**
+ * Session target not found.
+ */
+export declare function sessionTargetNotFoundError(): ErrorWithSuggestion;
+/**
+ * Session metadata missing.
+ */
+export declare function sessionMetadataMissingError(field: string): ErrorWithSuggestion;
+/**
+ * Script execution error with shell quote detection.
+ *
+ * Shows the script as received to help diagnose shell quote stripping issues.
+ * Detects common patterns like `querySelector(input)` that indicate shell damage.
+ *
+ * @param errorMessage - The JavaScript error message
+ * @param receivedScript - The script as received by the command (optional for backwards compat)
+ * @returns Error with context-aware suggestions
+ */
+export declare function scriptExecutionError(errorMessage: string, receivedScript?: string): ErrorWithSuggestion;
+/**
+ * Unexpected CDP response format.
+ */
+export declare function unexpectedResponseFormatError(context: string): ErrorWithSuggestion;
+/**
+ * Generic operation failure with dynamic error message.
+ */
+export declare function operationFailedError(operation: string, errorMessage: string): ErrorWithSuggestion;
+/**
+ * Internal error (should not happen in normal usage).
+ */
+export declare function internalError(context: string): ErrorWithSuggestion;
+/**
+ * No forms found on page.
+ */
+export declare function noFormsFoundError(): ErrorWithSuggestion;
+/**
+ * Form selection out of range.
+ */
+export declare function formSelectionOutOfRangeError(index: number, count: number): ErrorWithSuggestion;
+/**
+ * Form selection by name not found.
+ */
+export declare function formSelectionByNameNotFoundError(name: string, availableNames: string[]): ErrorWithSuggestion;
+/**
+ * Form in iframe (cross-origin or same-origin).
+ */
+export declare function formInIframeError(iframeUrl: string, crossOrigin: boolean): ErrorWithSuggestion;
+/**
+ * Custom component interaction warning.
+ */
+export declare function customComponentWarning(elementType: string, suggestedAction: string): ErrorWithSuggestion;
 //# sourceMappingURL=errors.d.ts.map

package/dist/ui/messages/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAcR;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAc1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY7D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"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"}

package/dist/ui/messages/errors.js

@@ -4,6 +4,7 @@
  * Centralized location for reusable error messages with consistent formatting.
  */
 import { formatDuration, joinLines } from '../../ui/formatting.js';
+import { detectSelectorQuoteDamage, detectScriptQuoteDamage, hasAttributeSelector, } from '../../utils/shellDetection.js';
 /**
  * Generate "session already running" error message.
  *
@@ -103,24 +104,292 @@ export function sessionNotActiveError(operation) {
     return joinLines(`Error: Cannot ${operation} - no active session`, '', 'Start a session first:', '  bdg <url>', '', 'Example:', '  bdg https://example.com', `  bdg ${operation}`);
 }
 /**
- * Generate element not found error with CDP fallback.
+ * Generate element not found error with shell quote detection and CDP fallback.
  *
- * Provides guidance for when high-level DOM commands fail to find elements,
- * including CDP alternatives for complex queries.
+ * Provides guidance for when high-level DOM commands fail to find elements.
+ * Detects shell quote damage for attribute selectors and provides specific
+ * recovery suggestions including the two-step query-then-inspect pattern.
  *
- * @param selector - CSS selector that failed
- * @returns Formatted error message with fallback suggestions
+ * @param selector - CSS selector that failed (as received by the command)
+ * @returns Formatted error message with context-aware suggestions
  *
  * @example
  * ```typescript
- * throw new CommandError(
- *   elementNotFoundError('#missing-element'),
- *   { cdpAlternative: 'Use Runtime.evaluate for complex queries' },
- *   EXIT_CODES.RESOURCE_NOT_FOUND
- * );
+ * // Simple selector - standard suggestions
+ * elementNotFoundError('#missing-element')
+ *
+ * // Attribute selector with shell damage detected
+ * elementNotFoundError('[data-test-id=value]')
+ * // Shows: "Shell quote handling detected. Selector received without quotes."
  * ```
  */
 export function elementNotFoundError(selector) {
-    return joinLines(`Error: Element not found: ${selector}`, '', 'Suggestions:', '  - Check the selector syntax', '  - Wait for the element to load (page might still be loading)', '  - Use bdg peek to see if page loaded correctly', '', 'Advanced: Use CDP for complex queries:', `  bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector('${selector}')"}'`);
+    const quoteCheck = detectSelectorQuoteDamage(selector);
+    if (quoteCheck.damaged) {
+        return joinLines(`Error: Element not found: ${selector}`, '', 'Shell quote handling detected. Selector received without quotes.', quoteCheck.details && `  ${quoteCheck.details}`, '', 'Discovery path (recommended):', `  1. Query first:  bdg dom query '${selector}'`, '  2. Then inspect: bdg dom a11y describe 0', '', 'Or escape quotes for direct use:', `  bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector(\\"${selector.replace(/=/g, '=\\\\\\"')}\\\\\\"\\")"}'`);
+    }
+    if (hasAttributeSelector(selector)) {
+        return joinLines(`Error: Element not found: ${selector}`, '', 'Attribute selector detected. If quotes were stripped by shell:', '', 'Discovery path (recommended):', `  1. Query first:  bdg dom query '${selector}'`, '  2. Then inspect: bdg dom a11y describe 0', '', 'Or verify element exists:', '  - Use bdg peek --dom to see page structure', '  - Check if element loads asynchronously');
+    }
+    return joinLines(`Error: Element not found: ${selector}`, '', 'Suggestions:', '  - Check the selector syntax', '  - Wait for the element to load (page might still be loading)', '  - Use bdg peek to see if page loaded correctly', '', 'Advanced: Use CDP for complex queries:', `  bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector(\\"${selector}\\")"}'`);
+}
+/**
+ * Index out of range error.
+ */
+export function indexOutOfRangeError(index, max) {
+    return {
+        message: `Index ${index} out of range (found ${max + 1} nodes)`,
+        suggestion: `Use an index between 0 and ${max}`,
+    };
+}
+/**
+ * Element at index not found (stale cache).
+ */
+export function elementAtIndexNotFoundError(index, selector) {
+    return {
+        message: `Element at index ${index} not found`,
+        suggestion: `Re-run "bdg dom query ${selector}" to refresh the cache`,
+    };
+}
+/**
+ * No nodes found for selector.
+ */
+export function noNodesFoundError(selector) {
+    return {
+        message: `No nodes found matching "${selector}"`,
+        suggestion: 'Verify the CSS selector is correct',
+    };
+}
+/**
+ * Element not visible/rendered.
+ */
+export function elementNotVisibleError() {
+    return {
+        message: 'Failed to get element bounds',
+        suggestion: 'Element may not be rendered or visible',
+    };
+}
+/**
+ * Element has zero dimensions.
+ */
+export function elementZeroDimensionsError() {
+    return {
+        message: 'Element has zero dimensions (not visible)',
+        suggestion: 'Element may be hidden or collapsed',
+    };
+}
+/**
+ * Missing required argument.
+ */
+export function missingArgumentError(usage) {
+    return {
+        message: 'Missing required argument or flag',
+        suggestion: usage,
+    };
+}
+/**
+ * Either/or argument required.
+ */
+export function eitherArgumentRequiredError(arg1, arg2, example) {
+    return {
+        message: `Either ${arg1} or ${arg2} must be provided`,
+        suggestion: example,
+    };
+}
+/**
+ * Invalid query pattern.
+ */
+export function invalidQueryPatternError(pattern) {
+    return {
+        message: 'Query pattern must specify at least one field',
+        suggestion: `Received: "${pattern}". Try: bdg dom a11y query "role:button" or "name:Submit"`,
+    };
+}
+/**
+ * No a11y nodes matching pattern.
+ */
+export function noA11yNodesFoundError(pattern) {
+    return {
+        message: 'No nodes found matching pattern',
+        suggestion: `Pattern: ${pattern}. Try a broader query or use "bdg dom a11y tree" to see all elements`,
+    };
+}
+/**
+ * Element not accessible (a11y).
+ */
+export function elementNotAccessibleError(index) {
+    return {
+        message: `Element at index ${index} not accessible`,
+        suggestion: 'Re-run query to refresh cache',
+    };
+}
+/**
+ * Fillable element not found.
+ */
+export function fillableElementNotFoundError(selector) {
+    return {
+        message: `Element not found: ${selector}`,
+        suggestion: 'Verify the selector matches a fillable element (input, textarea, select)',
+    };
+}
+/**
+ * Clickable element not found.
+ */
+export function clickableElementNotFoundError(selector) {
+    return {
+        message: `Element not found: ${selector}`,
+        suggestion: 'Verify the selector matches a clickable element',
+    };
+}
+/**
+ * Key press failed.
+ */
+export function keyPressFailedError(details) {
+    return {
+        message: 'Failed to press key',
+        suggestion: details,
+    };
+}
+/**
+ * Session target not found.
+ */
+export function sessionTargetNotFoundError() {
+    return {
+        message: 'Session target not found (tab may have been closed)',
+        suggestion: 'Start a new session with: bdg <url>',
+    };
+}
+/**
+ * Session metadata missing.
+ */
+export function sessionMetadataMissingError(field) {
+    return {
+        message: `Session metadata missing ${field}`,
+        suggestion: 'Start a new session with: bdg <url>',
+    };
+}
+/**
+ * Script execution error with shell quote detection.
+ *
+ * Shows the script as received to help diagnose shell quote stripping issues.
+ * Detects common patterns like `querySelector(input)` that indicate shell damage.
+ *
+ * @param errorMessage - The JavaScript error message
+ * @param receivedScript - The script as received by the command (optional for backwards compat)
+ * @returns Error with context-aware suggestions
+ */
+export function scriptExecutionError(errorMessage, receivedScript) {
+    if (!receivedScript) {
+        return {
+            message: errorMessage,
+            suggestion: 'Check JavaScript syntax and ensure the expression is valid',
+        };
+    }
+    const quoteCheck = detectScriptQuoteDamage(receivedScript);
+    const truncatedScript = receivedScript.length > 100 ? receivedScript.slice(0, 100) + '...' : receivedScript;
+    const lines = [];
+    lines.push(`Script received: ${truncatedScript}`);
+    if (quoteCheck.damaged) {
+        lines.push('');
+        lines.push('Shell quote damage detected:');
+        if (quoteCheck.details) {
+            lines.push(`  ${quoteCheck.details}`);
+        }
+        if (quoteCheck.suggestion) {
+            lines.push('');
+            lines.push(quoteCheck.suggestion);
+        }
+    }
+    else {
+        lines.push('');
+        lines.push('Tips:');
+        lines.push("  - Use single quotes around script: bdg dom eval '...'");
+        lines.push('  - For complex scripts, use heredoc or --file option');
+        lines.push('  - Escape inner quotes: \\" or use opposite quote style');
+    }
+    return {
+        message: errorMessage,
+        suggestion: lines.join('\n'),
+    };
+}
+/**
+ * Unexpected CDP response format.
+ */
+export function unexpectedResponseFormatError(context) {
+    return {
+        message: 'Unexpected response format',
+        suggestion: `CDP response missing result.value or invalid ${context} structure`,
+    };
+}
+/**
+ * Generic operation failure with dynamic error message.
+ */
+export function operationFailedError(operation, errorMessage) {
+    return {
+        message: `Failed to ${operation}`,
+        suggestion: errorMessage,
+    };
+}
+/**
+ * Internal error (should not happen in normal usage).
+ */
+export function internalError(context) {
+    return {
+        message: context,
+        suggestion: 'This is an internal error - please report this issue',
+    };
+}
+/**
+ * No forms found on page.
+ */
+export function noFormsFoundError() {
+    return {
+        message: 'No forms discovered on the page',
+        suggestion: 'Check if forms exist with: bdg dom query "form, input, [role=textbox]" or inspect the page manually',
+    };
+}
+/**
+ * Form selection out of range.
+ */
+export function formSelectionOutOfRangeError(index, count) {
+    return {
+        message: `Form index ${index} out of range (found ${count} form${count === 1 ? '' : 's'})`,
+        suggestion: count > 0 ? `Use an index between 0 and ${count - 1}` : 'No forms found on page',
+    };
+}
+/**
+ * Form selection by name not found.
+ */
+export function formSelectionByNameNotFoundError(name, availableNames) {
+    const nameList = availableNames.length > 0
+        ? `Available forms: ${availableNames.join(', ')}`
+        : 'No named forms found';
+    return {
+        message: `No form found matching "${name}"`,
+        suggestion: `${nameList}. Use --all to see all forms.`,
+    };
+}
+/**
+ * Form in iframe (cross-origin or same-origin).
+ */
+export function formInIframeError(iframeUrl, crossOrigin) {
+    const originNote = crossOrigin
+        ? 'Cross-origin iframe - cannot inspect directly'
+        : 'Same-origin iframe - use frame commands to access';
+    return {
+        message: `Form is inside an iframe: ${iframeUrl}`,
+        suggestion: crossOrigin
+            ? `${originNote}. Manual interaction required for cross-origin frames.`
+            : `${originNote}. Try: bdg dom frame list, then bdg dom frame attach <id>`,
+    };
+}
+/**
+ * Custom component interaction warning.
+ */
+export function customComponentWarning(elementType, suggestedAction) {
+    return {
+        message: `Custom component detected: ${elementType}`,
+        suggestion: `Standard fill may not work. Try: ${suggestedAction}`,
+    };
 }
 //# sourceMappingURL=errors.js.map

package/dist/ui/messages/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAW,EACX,QAAgB,EAChB,SAAkB;IAElB,OAAO,SAAS,CACd,EAAE,EACF,gCAAgC,EAChC,EAAE,EACF,eAAe,GAAG,EAAE,EACpB,SAAS,IAAI,eAAe,SAAS,EAAE,EACvC,eAAe,cAAc,CAAC,QAAQ,CAAC,EAAE,EACzC,EAAE,EACF,cAAc,EACd,gCAAgC,EAChC,2CAA2C,EAC3C,EAAE,CACH,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO,SAAS,CACd,2BAA2B,EAC3B,OAAO,EAAE,cAAc,IAAI,iCAAiC,EAC5D,OAAO,EAAE,SAAS,IAAI,eAAe,OAAO,CAAC,SAAS,EAAE,EACxD,EAAE,EACF,sBAAsB,EACtB,aAAa,EACb,OAAO,EAAE,aAAa,IAAI,EAAE,EAC5B,OAAO,EAAE,aAAa,IAAI,yBAAyB,EACnD,OAAO,EAAE,aAAa,IAAI,cAAc,EACxC,OAAO,EAAE,YAAY,IAAI,EAAE,EAC3B,OAAO,EAAE,YAAY,IAAI,gDAAgD,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgB;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,UAAU,OAAO,KAAK,OAAO,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,uCAAuC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,SAAS,CACd,iBAAiB,SAAS,sBAAsB,EAChD,EAAE,EACF,wBAAwB,EACxB,aAAa,EACb,EAAE,EACF,UAAU,EACV,2BAA2B,EAC3B,SAAS,SAAS,EAAE,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,SAAS,CACd,6BAA6B,QAAQ,EAAE,EACvC,EAAE,EACF,cAAc,EACd,+BAA+B,EAC/B,gEAAgE,EAChE,kDAAkD,EAClD,EAAE,EACF,wCAAwC,EACxC,+EAA+E,QAAQ,OAAO,CAC/F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAW,EACX,QAAgB,EAChB,SAAkB;IAElB,OAAO,SAAS,CACd,EAAE,EACF,gCAAgC,EAChC,EAAE,EACF,eAAe,GAAG,EAAE,EACpB,SAAS,IAAI,eAAe,SAAS,EAAE,EACvC,eAAe,cAAc,CAAC,QAAQ,CAAC,EAAE,EACzC,EAAE,EACF,cAAc,EACd,gCAAgC,EAChC,2CAA2C,EAC3C,EAAE,CACH,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO,SAAS,CACd,2BAA2B,EAC3B,OAAO,EAAE,cAAc,IAAI,iCAAiC,EAC5D,OAAO,EAAE,SAAS,IAAI,eAAe,OAAO,CAAC,SAAS,EAAE,EACxD,EAAE,EACF,sBAAsB,EACtB,aAAa,EACb,OAAO,EAAE,aAAa,IAAI,EAAE,EAC5B,OAAO,EAAE,aAAa,IAAI,yBAAyB,EACnD,OAAO,EAAE,aAAa,IAAI,cAAc,EACxC,OAAO,EAAE,YAAY,IAAI,EAAE,EAC3B,OAAO,EAAE,YAAY,IAAI,gDAAgD,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgB;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,UAAU,OAAO,KAAK,OAAO,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,uCAAuC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,SAAS,CACd,iBAAiB,SAAS,sBAAsB,EAChD,EAAE,EACF,wBAAwB,EACxB,aAAa,EACb,EAAE,EACF,UAAU,EACV,2BAA2B,EAC3B,SAAS,SAAS,EAAE,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,UAAU,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAEvD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,SAAS,CACd,6BAA6B,QAAQ,EAAE,EACvC,EAAE,EACF,kEAAkE,EAClE,UAAU,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,EAC/C,EAAE,EACF,+BAA+B,EAC/B,qCAAqC,QAAQ,GAAG,EAChD,4CAA4C,EAC5C,EAAE,EACF,kCAAkC,EAClC,iFAAiF,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,gBAAgB,CACpI,CAAC;IACJ,CAAC;IAED,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CACd,6BAA6B,QAAQ,EAAE,EACvC,EAAE,EACF,gEAAgE,EAChE,EAAE,EACF,+BAA+B,EAC/B,qCAAqC,QAAQ,GAAG,EAChD,4CAA4C,EAC5C,EAAE,EACF,2BAA2B,EAC3B,8CAA8C,EAC9C,2CAA2C,CAC5C,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CACd,6BAA6B,QAAQ,EAAE,EACvC,EAAE,EACF,cAAc,EACd,+BAA+B,EAC/B,gEAAgE,EAChE,kDAAkD,EAClD,EAAE,EACF,wCAAwC,EACxC,iFAAiF,QAAQ,SAAS,CACnG,CAAC;AACJ,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,GAAW;IAC7D,OAAO;QACL,OAAO,EAAE,SAAS,KAAK,wBAAwB,GAAG,GAAG,CAAC,SAAS;QAC/D,UAAU,EAAE,8BAA8B,GAAG,EAAE;KAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAa,EAAE,QAAgB;IACzE,OAAO;QACL,OAAO,EAAE,oBAAoB,KAAK,YAAY;QAC9C,UAAU,EAAE,yBAAyB,QAAQ,wBAAwB;KACtE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO;QACL,OAAO,EAAE,4BAA4B,QAAQ,GAAG;QAChD,UAAU,EAAE,oCAAoC;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,OAAO,EAAE,8BAA8B;QACvC,UAAU,EAAE,wCAAwC;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,OAAO,EAAE,2CAA2C;QACpD,UAAU,EAAE,oCAAoC;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO;QACL,OAAO,EAAE,mCAAmC;QAC5C,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,OAAO,EAAE,UAAU,IAAI,OAAO,IAAI,mBAAmB;QACrD,UAAU,EAAE,OAAO;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,OAAO;QACL,OAAO,EAAE,+CAA+C;QACxD,UAAU,EAAE,cAAc,OAAO,2DAA2D;KAC7F,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO;QACL,OAAO,EAAE,iCAAiC;QAC1C,UAAU,EAAE,YAAY,OAAO,sEAAsE;KACtG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO;QACL,OAAO,EAAE,oBAAoB,KAAK,iBAAiB;QACnD,UAAU,EAAE,+BAA+B;KAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC3D,OAAO;QACL,OAAO,EAAE,sBAAsB,QAAQ,EAAE;QACzC,UAAU,EAAE,0EAA0E;KACvF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,OAAO;QACL,OAAO,EAAE,sBAAsB,QAAQ,EAAE;QACzC,UAAU,EAAE,iDAAiD;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO;QACL,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,OAAO;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,OAAO,EAAE,qDAAqD;QAC9D,UAAU,EAAE,qCAAqC;KAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,OAAO;QACL,OAAO,EAAE,4BAA4B,KAAK,EAAE;QAC5C,UAAU,EAAE,qCAAqC;KAClD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,cAAuB;IAEvB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,UAAU,EAAE,4DAA4D;SACzE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,eAAe,GACnB,cAAc,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC;IAEtF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,oBAAoB,eAAe,EAAE,CAAC,CAAC;IAElD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACzE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAe;IAC3D,OAAO;QACL,OAAO,EAAE,4BAA4B;QACrC,UAAU,EAAE,gDAAgD,OAAO,YAAY;KAChF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,YAAoB;IAC1E,OAAO;QACL,OAAO,EAAE,aAAa,SAAS,EAAE;QACjC,UAAU,EAAE,YAAY;KACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,sDAAsD;KACnE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,OAAO,EAAE,iCAAiC;QAC1C,UAAU,EACR,qGAAqG;KACxG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAa,EAAE,KAAa;IACvE,OAAO;QACL,OAAO,EAAE,cAAc,KAAK,wBAAwB,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QAC1F,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,wBAAwB;KAC7F,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAAY,EACZ,cAAwB;IAExB,MAAM,QAAQ,GACZ,cAAc,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,oBAAoB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACjD,CAAC,CAAC,sBAAsB,CAAC;IAC7B,OAAO;QACL,OAAO,EAAE,2BAA2B,IAAI,GAAG;QAC3C,UAAU,EAAE,GAAG,QAAQ,+BAA+B;KACvD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,WAAoB;IACvE,MAAM,UAAU,GAAG,WAAW;QAC5B,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,mDAAmD,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,6BAA6B,SAAS,EAAE;QACjD,UAAU,EAAE,WAAW;YACrB,CAAC,CAAC,GAAG,UAAU,wDAAwD;YACvE,CAAC,CAAC,GAAG,UAAU,2DAA2D;KAC7E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,eAAuB;IAEvB,OAAO;QACL,OAAO,EAAE,8BAA8B,WAAW,EAAE;QACpD,UAAU,EAAE,oCAAoC,eAAe,EAAE;KAClE,CAAC;AACJ,CAAC"}

package/dist/utils/__tests__/shellDetection.unit.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shell Detection Unit Tests
+ *
+ * Tests shell quote damage detection for selectors and scripts.
+ *
+ * Following testing philosophy:
+ * - Test the BEHAVIOR: "Detects damaged input, provides actionable suggestions"
+ * - Test the PROPERTY: "Never throws, always returns valid result"
+ * - No mocking needed - pure utility functions
+ */
+export {};
+//# sourceMappingURL=shellDetection.unit.test.d.ts.map

package/dist/utils/__tests__/shellDetection.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellDetection.unit.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/shellDetection.unit.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}