@tontoko/fast-playwright-mcp 0.1.1 → 0.1.3

package/lib/types/html-inspection.js

@@ -0,0 +1,106 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/types/html-inspection.ts
+import { z } from "zod";
+import { elementSelectorSchema } from "./selectors.js";
+var htmlInspectionOptionsSchema = z.object({
+  selectors: z.array(elementSelectorSchema).min(1).describe("Array of element selectors to inspect"),
+  depth: z.number().min(1).max(10).optional().default(2).describe("Maximum hierarchy depth to extract"),
+  includeStyles: z.boolean().optional().default(false).describe("Include computed CSS styles"),
+  maxSize: z.number().min(1024).max(500000).optional().default(50000).describe("Maximum size in bytes (1KB-500KB)"),
+  format: z.enum(["html", "aria", "text"]).optional().default("html").describe("Output format"),
+  includeAttributes: z.boolean().optional().default(true).describe("Include element attributes"),
+  preserveWhitespace: z.boolean().optional().default(false).describe("Preserve whitespace in content"),
+  excludeSelector: z.string().optional().describe("CSS selector to exclude elements")
+});
+var HTMLInspectionError = {
+  SELECTOR_NOT_FOUND: "SELECTOR_NOT_FOUND",
+  SIZE_LIMIT_EXCEEDED: "SIZE_LIMIT_EXCEEDED",
+  EXTRACTION_TIMEOUT: "EXTRACTION_TIMEOUT",
+  INVALID_SELECTOR: "INVALID_SELECTOR",
+  DOM_ACCESS_ERROR: "DOM_ACCESS_ERROR"
+};
+function calculateHtmlSize(html) {
+  return new TextEncoder().encode(html).length;
+}
+function truncateHtml(html, maxSize) {
+  if (calculateHtmlSize(html) <= maxSize) {
+    return { html, truncated: false };
+  }
+  const truncated = html.substring(0, maxSize - 100);
+  const lastTag = truncated.lastIndexOf("<");
+  const safeHtml = lastTag > truncated.lastIndexOf(">") ? truncated.substring(0, lastTag) : truncated;
+  return { html: `${safeHtml}<!-- TRUNCATED -->`, truncated: true };
+}
+function validateHTMLInspectionOptions(options) {
+  return htmlInspectionOptionsSchema.parse(options);
+}
+function generateHTMLInspectionSuggestions(result) {
+  const suggestions = [];
+  if (result.truncated) {
+    suggestions.push("Content was truncated. Consider reducing depth or using more specific selectors.");
+  }
+  if (result.stats.selectorsNotFound > 0) {
+    suggestions.push("Some selectors did not match elements. Try using more specific or alternative selectors.");
+  }
+  if (result.timing.totalMs > 5000) {
+    suggestions.push("Inspection took longer than expected. Consider reducing scope or depth.");
+  }
+  if (result.stats.averageDepth > 5) {
+    suggestions.push("Deep element extraction detected. Consider limiting depth for better performance.");
+  }
+  return suggestions;
+}
+var HTMLInspectionUtils = {
+  calculateHtmlSize,
+  truncateHtml,
+  validateOptions: validateHTMLInspectionOptions,
+  generateSuggestions: generateHTMLInspectionSuggestions
+};
+var HTMLInspectionConstants = {
+  DEFAULT_MAX_SIZE: 50000,
+  DEFAULT_DEPTH: 2,
+  MAX_DEPTH: 10,
+  DEFAULT_TIMEOUT_MS: 1e4,
+  SIZE_THRESHOLDS: {
+    WARNING: 30000,
+    CRITICAL: 45000
+  },
+  COMMON_ARIA_PROPERTIES: [
+    "aria-label",
+    "aria-describedby",
+    "aria-hidden",
+    "aria-expanded",
+    "aria-selected",
+    "aria-checked",
+    "aria-disabled",
+    "aria-required"
+  ]
+};
+export {
+  validateHTMLInspectionOptions,
+  truncateHtml,
+  htmlInspectionOptionsSchema,
+  generateHTMLInspectionSuggestions,
+  calculateHtmlSize,
+  HTMLInspectionUtils,
+  HTMLInspectionError,
+  HTMLInspectionConstants
+};

package/lib/types/selectors.js

@@ -0,0 +1,126 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/types/selectors.ts
+import { z } from "zod";
+var refSelectorSchema = z.object({
+  ref: z.string().describe("System-generated element ID from previous tool results")
+});
+var roleSelectorSchema = z.object({
+  role: z.string().describe("ARIA role to match (e.g., button, textbox, link)"),
+  text: z.string().optional().describe("Optional text content to match within the role")
+});
+var cssSelectorSchema = z.object({
+  css: z.string().describe('CSS selector string (e.g., "#id", ".class", "button[type=submit]")')
+});
+var textSelectorSchema = z.object({
+  text: z.string().describe("Text content to search for"),
+  tag: z.string().optional().describe("Optional HTML tag to limit search scope")
+});
+var elementSelectorSchema = z.union([
+  refSelectorSchema,
+  roleSelectorSchema,
+  cssSelectorSchema,
+  textSelectorSchema
+]).describe("Element selector supporting ref, role, CSS, or text-based selection");
+var SelectorConfidence = {
+  HIGH: 0.9,
+  MEDIUM: 0.7,
+  LOW: 0.5,
+  VERY_LOW: 0.3
+};
+var ResolutionStrategy = {
+  REF: "ref",
+  CSS_PARALLEL: "css_parallel",
+  ROLE_SEQUENTIAL: "role_sequential",
+  TEXT_FALLBACK: "text_fallback"
+};
+function isRefSelector(selector) {
+  return "ref" in selector;
+}
+function isRoleSelector(selector) {
+  return "role" in selector;
+}
+function isCSSSelector(selector) {
+  return "css" in selector;
+}
+function isTextSelector(selector) {
+  return "text" in selector && !("role" in selector);
+}
+function validateElementSelector(selector) {
+  return elementSelectorSchema.parse(selector);
+}
+function isValidSelector(selector) {
+  try {
+    elementSelectorSchema.parse(selector);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var SelectorValidator = {
+  validateElementSelector,
+  isValidSelector
+};
+var SelectorPatterns = {
+  ARIA_ROLES: [
+    "button",
+    "textbox",
+    "link",
+    "checkbox",
+    "radio",
+    "combobox",
+    "listbox",
+    "option",
+    "tab",
+    "tabpanel",
+    "dialog",
+    "alert",
+    "menu",
+    "menuitem",
+    "table",
+    "row",
+    "cell",
+    "heading"
+  ],
+  CSS_PATTERNS: {
+    byId: (id) => `#${id}`,
+    byClass: (className) => `.${className}`,
+    byAttribute: (attr, value) => value ? `[${attr}="${value}"]` : `[${attr}]`,
+    byDataTestId: (testId) => `[data-testid="${testId}"]`,
+    byRole: (role) => `[role="${role}"]`
+  }
+};
+export {
+  validateElementSelector,
+  textSelectorSchema,
+  roleSelectorSchema,
+  refSelectorSchema,
+  isValidSelector,
+  isTextSelector,
+  isRoleSelector,
+  isRefSelector,
+  isCSSSelector,
+  elementSelectorSchema,
+  cssSelectorSchema,
+  SelectorValidator,
+  SelectorPatterns,
+  SelectorConfidence,
+  ResolutionStrategy
+};