safari-devtools-mcp 1.6.0 → 1.8.0

package/README.md

@@ -208,7 +208,7 @@ The server exposes guided debugging workflows as MCP prompts. Clients that suppo
 | `safari-specific-debugging` | Debug WebKit quirks — CSS prefixes, JS feature gaps, ITP/CORS issues             |
 | `performance-debugging`     | Performance analysis — Navigation Timing, Core Web Vitals, resource waterfall    |
 
-## Tools (41)
+## Tools (45)
 
 ### Debugging
 
@@ -286,6 +286,20 @@ The server exposes guided debugging workflows as MCP prompts. Clients that suppo
 | `press_key`     | Press a key or combination (e.g., `Meta+A`, `Enter`) |
 | `upload_file`   | Upload a file through a file input                   |
 
+### iOS Safari validation
+
+| Tool                          | Description                                                                                                    |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `inspect_viewport_meta`       | Parse the viewport meta tag and validate against iOS best practices (width, zoom, viewport-fit)                |
+| `get_safe_area_insets`        | Read CSS safe-area-inset values and check whether the page handles notched devices correctly                   |
+| `check_ios_web_app_readiness` | Audit the page for Add to Home Screen / PWA readiness (apple-touch-icon, manifest, splash screens, status bar) |
+
+### WebKit CSS compatibility
+
+| Tool                         | Description                                                                                                    |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `check_webkit_compatibility` | Scan stylesheets for Safari CSS issues — missing -webkit- prefixes, known WebKit quirks, and deprecated syntax |
+
 ## Architecture
 
 ```

package/build/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAoC/C,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAAkB,GAAG;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CA2CA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAyC/C,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAAkB,GAAG;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CA2CA"}

package/build/src/index.js

@@ -21,7 +21,9 @@ import { tools as cssTools } from './tools/css.js';
 import { tools as cookieTools } from './tools/cookies.js';
 import { tools as storageTools } from './tools/storage.js';
 import { tools as inputTools } from './tools/input.js';
-import { tools as emulationTools } from './tools/emulation.js';
+import { tools as emulationTools, deviceTools } from './tools/emulation.js';
+import { tools as iosValidationTools } from './tools/ios-validation.js';
+import { tools as webkitCompatTools } from './tools/webkit-compat.js';
 const allTools = [
     ...consoleTools,
     ...networkTools,
@@ -36,6 +38,9 @@ const allTools = [
     ...storageTools,
     ...inputTools,
     ...emulationTools,
+    ...deviceTools,
+    ...iosValidationTools,
+    ...webkitCompatTools,
 ];
 export function createSafariMcpServer(options = {}) {
     const { slim = false } = options;

package/build/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAGrC,8CAA8C;AAC9C,OAAO,EAAC,KAAK,IAAI,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAC,KAAK,IAAI,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAC,KAAK,IAAI,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAC,KAAK,IAAI,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAC,KAAK,IAAI,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAC,KAAK,IAAI,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAC,KAAK,IAAI,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAC,KAAK,IAAI,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAC,KAAK,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAC,KAAK,IAAI,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,KAAK,IAAI,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAC,KAAK,IAAI,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAC,KAAK,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAE7D,MAAM,QAAQ,GAAc;IAC1B,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,eAAe;IAClB,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,gBAAgB;IACnB,GAAG,WAAW;IACd,GAAG,QAAQ;IACX,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,UAAU;IACb,GAAG,cAAc;CAClB,CAAC;AAOF,MAAM,UAAU,qBAAqB,CAAC,UAAyB,EAAE;IAI/D,MAAM,EAAC,IAAI,GAAG,KAAK,EAAC,GAAG,OAAO,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAElC,6CAA6C;IAC7C,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,WAAW,GACf,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QAEzE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;YAC9D,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;yBACzE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAC,MAAM,EAAE,MAAM,EAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/build/src/tools/emulation.d.ts

@@ -13,4 +13,5 @@
  */
 import { z } from 'zod';
 export declare const tools: import("./types.js").ToolDef<z.ZodRawShape>[];
+export declare const deviceTools: import("./types.js").ToolDef<z.ZodRawShape>[];
 //# sourceMappingURL=emulation.d.ts.map

package/build/src/tools/emulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emulation.d.ts","sourceRoot":"","sources":["../../../src/tools/emulation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAStB,eAAO,MAAM,KAAK,+CA2LjB,CAAC"}
+{"version":3,"file":"emulation.d.ts","sourceRoot":"","sources":["../../../src/tools/emulation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAStB,eAAO,MAAM,KAAK,+CA2LjB,CAAC;AAiFF,eAAO,MAAM,WAAW,+CAoMvB,CAAC"}

package/build/src/tools/emulation.js

@@ -193,4 +193,243 @@ export const tools = [
         },
     }),
 ];
+const SAFARI_VERSION = '605.1.15';
+const WEBKIT_VERSION = '605.1.15';
+const OS_VERSION_IOS = '18_0';
+const OS_VERSION_IPAD = '18_0';
+const DEVICE_PRESETS = {
+    'iPhone SE': {
+        width: 375,
+        height: 667,
+        devicePixelRatio: 2,
+        userAgent: `Mozilla/5.0 (iPhone; CPU iPhone OS ${OS_VERSION_IOS} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPhone 14': {
+        width: 390,
+        height: 844,
+        devicePixelRatio: 3,
+        userAgent: `Mozilla/5.0 (iPhone; CPU iPhone OS ${OS_VERSION_IOS} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPhone 15 Pro': {
+        width: 393,
+        height: 852,
+        devicePixelRatio: 3,
+        userAgent: `Mozilla/5.0 (iPhone; CPU iPhone OS ${OS_VERSION_IOS} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPhone 16 Pro Max': {
+        width: 440,
+        height: 956,
+        devicePixelRatio: 3,
+        userAgent: `Mozilla/5.0 (iPhone; CPU iPhone OS ${OS_VERSION_IOS} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPad Mini': {
+        width: 744,
+        height: 1133,
+        devicePixelRatio: 2,
+        userAgent: `Mozilla/5.0 (iPad; CPU OS ${OS_VERSION_IPAD} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPad Air': {
+        width: 820,
+        height: 1180,
+        devicePixelRatio: 2,
+        userAgent: `Mozilla/5.0 (iPad; CPU OS ${OS_VERSION_IPAD} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPad Pro 11': {
+        width: 834,
+        height: 1194,
+        devicePixelRatio: 2,
+        userAgent: `Mozilla/5.0 (iPad; CPU OS ${OS_VERSION_IPAD} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+    'iPad Pro 13': {
+        width: 1024,
+        height: 1366,
+        devicePixelRatio: 2,
+        userAgent: `Mozilla/5.0 (iPad; CPU OS ${OS_VERSION_IPAD} like Mac OS X) AppleWebKit/${WEBKIT_VERSION} (KHTML, like Gecko) Version/18.0 Mobile/${SAFARI_VERSION} Safari/${SAFARI_VERSION}`,
+        mobile: true,
+    },
+};
+const PRESET_NAMES = Object.keys(DEVICE_PRESETS);
+export const deviceTools = [
+    defineTool({
+        name: 'set_device_emulation',
+        description: 'Emulate an Apple device by resizing the viewport and overriding ' +
+            'device pixel ratio and touch support at the JS level. The user agent ' +
+            'is overridden via navigator.userAgent (JS-level only — HTTP request ' +
+            'headers are not affected). Choose a preset ' +
+            `(${PRESET_NAMES.join(', ')}) or provide custom values. ` +
+            'Use reset_device_emulation to restore defaults.',
+        slimDescription: 'Emulate iPhone/iPad viewport and UA.',
+        schema: {
+            device: z
+                .enum(PRESET_NAMES)
+                .optional()
+                .describe('Apple device preset name. Overrides width/height/dpr/userAgent if provided.'),
+            width: z
+                .number()
+                .min(200)
+                .max(3840)
+                .optional()
+                .describe('Viewport width in CSS pixels.'),
+            height: z
+                .number()
+                .min(200)
+                .max(2160)
+                .optional()
+                .describe('Viewport height in CSS pixels.'),
+            devicePixelRatio: z
+                .number()
+                .min(1)
+                .max(4)
+                .optional()
+                .describe('Device pixel ratio (e.g. 2 for Retina).'),
+            userAgent: z
+                .string()
+                .optional()
+                .describe('Custom user agent string (JS-level override only; HTTP headers unchanged).'),
+        },
+        handler: async (params, driver) => {
+            const preset = params.device ? DEVICE_PRESETS[params.device] : undefined;
+            const width = params.width ?? preset?.width;
+            const height = params.height ?? preset?.height;
+            const dpr = params.devicePixelRatio ?? preset?.devicePixelRatio;
+            const ua = params.userAgent ?? preset?.userAgent;
+            const mobile = preset?.mobile ?? false;
+            if (!width || !height) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Provide a device preset or both width and height.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Save original window size before resizing
+            const originalSize = await driver.runScript(`({w: window.outerWidth, h: window.outerHeight})`);
+            // Resize the browser window
+            await driver.resizePage(width, height);
+            // Inject JS overrides for DPR, UA, and touch
+            const overrides = [];
+            if (dpr)
+                overrides.push(`dpr: ${dpr}`);
+            if (ua)
+                overrides.push(`ua: ${JSON.stringify(ua)}`);
+            overrides.push(`mobile: ${mobile}`);
+            overrides.push(`origW: ${originalSize.w}`);
+            overrides.push(`origH: ${originalSize.h}`);
+            await driver.runScript(`((opts) => {
+        // Save originals for reset (only on first call)
+        if (!window.__safariMcpDeviceOriginals) {
+          window.__safariMcpDeviceOriginals = {
+            windowWidth: opts.origW,
+            windowHeight: opts.origH,
+            hadOntouchstart: 'ontouchstart' in window,
+          };
+        }
+
+        if (opts.dpr) {
+          Object.defineProperty(window, 'devicePixelRatio', {
+            get: () => opts.dpr, configurable: true
+          });
+        }
+
+        if (opts.ua) {
+          Object.defineProperty(navigator, 'userAgent', {
+            get: () => opts.ua, configurable: true
+          });
+        }
+
+        if (opts.mobile) {
+          Object.defineProperty(navigator, 'maxTouchPoints', {
+            get: () => 5, configurable: true
+          });
+          if (!window.__safariMcpDeviceOriginals.hadOntouchstart) {
+            window.ontouchstart = null;
+          }
+        }
+      })({${overrides.join(', ')}})`);
+            const label = params.device ?? `${width}×${height}`;
+            const details = [
+                `viewport: ${width}×${height}`,
+                dpr ? `dpr: ${dpr}` : null,
+                ua ? 'user agent: overridden (JS-level)' : null,
+                mobile ? 'touch: enabled' : null,
+            ]
+                .filter(Boolean)
+                .join(', ');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Device emulation set to ${label} (${details}).`,
+                    },
+                ],
+            };
+        },
+    }),
+    defineTool({
+        name: 'reset_device_emulation',
+        description: 'Remove all device emulation overrides and restore the original ' +
+            'viewport size, JS-level user agent, device pixel ratio, and touch settings.',
+        slimDescription: 'Reset device emulation.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        const orig = window.__safariMcpDeviceOriginals;
+        if (!orig) return { restored: false, windowWidth: 0, windowHeight: 0 };
+
+        // Delete own property overrides to expose prototype originals
+        const dprDesc = Object.getOwnPropertyDescriptor(window, 'devicePixelRatio');
+        if (dprDesc && dprDesc.configurable) delete window.devicePixelRatio;
+
+        const uaDesc = Object.getOwnPropertyDescriptor(navigator, 'userAgent');
+        if (uaDesc && uaDesc.configurable) delete navigator.userAgent;
+
+        const touchDesc = Object.getOwnPropertyDescriptor(navigator, 'maxTouchPoints');
+        if (touchDesc && touchDesc.configurable) delete navigator.maxTouchPoints;
+
+        // Only remove ontouchstart if we added it
+        if (!orig.hadOntouchstart && 'ontouchstart' in window) {
+          delete window.ontouchstart;
+        }
+
+        const ww = orig.windowWidth;
+        const wh = orig.windowHeight;
+        delete window.__safariMcpDeviceOriginals;
+
+        return { restored: true, windowWidth: ww, windowHeight: wh };
+      })()`);
+            if (!result.restored) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No device emulation was active.',
+                        },
+                    ],
+                };
+            }
+            // Restore original window size
+            if (result.windowWidth && result.windowHeight) {
+                await driver.resizePage(result.windowWidth, result.windowHeight);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Device emulation reset. Viewport, DPR, UA, and touch settings restored.',
+                    },
+                ],
+            };
+        },
+    }),
+];
 //# sourceMappingURL=emulation.js.map

package/build/src/tools/emulation.js.map

@@ -1 +1 @@
-{"version":3,"file":"emulation.js","sourceRoot":"","sources":["../../../src/tools/emulation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAEtC,MAAM,iBAAiB,GAAG,CAAC;KACxB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,QAAQ,CACP,iHAAiH,CAClH,CAAC;AAEJ,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,CAAC;QACT,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,sEAAsE;YACtE,6DAA6D;YAC7D,gEAAgE;YAChE,kEAAkE;YAClE,qBAAqB;QACvB,eAAe,EAAE,0BAA0B;QAC3C,MAAM,EAAE;YACN,WAAW,EAAE,iBAAiB;SAC/B;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAChC,MAAM,EAAC,WAAW,EAAC,GAAG,MAAM,CAAC;YAE7B,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBAC5B,MAAM,MAAM,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA6BlB,CAAC,CAAC;gBAEP,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,yDAAyD;yBAChE;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAmFjB,WAAW,IAAI,CAAC,CAAC;YAEvB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wBAAwB,WAAW,4EAA4E,WAAW,QAAQ;qBACzI;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,UAAU,CAAC;QACT,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,qEAAqE;YACrE,6DAA6D;QAC/D,eAAe,EAAE,sCAAsC;QACvD,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAGlC;;;;;;;WAOE,CAAC,CAAC;YAEP,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc;gBAClC,CAAC,CAAC,wBAAwB;gBAC1B,CAAC,CAAC,mBAAmB,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yBAAyB,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE;qBACxD;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;CACH,CAAC"}
+{"version":3,"file":"emulation.js","sourceRoot":"","sources":["../../../src/tools/emulation.ts"],"names":[],"mappings":"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"}

package/build/src/tools/ios-validation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * iOS Safari validation tools.
+ *
+ * Inspect viewport meta tags, safe-area insets, and PWA readiness —
+ * the three things every iOS Safari developer has to fight with.
+ */
+export declare const tools: import("./types.js").ToolDef<import("zod").ZodRawShape>[];
+//# sourceMappingURL=ios-validation.d.ts.map

package/build/src/tools/ios-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-validation.d.ts","sourceRoot":"","sources":["../../../src/tools/ios-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyEH,eAAO,MAAM,KAAK,2DA6QjB,CAAC"}

package/build/src/tools/ios-validation.js

@@ -0,0 +1,282 @@
+/**
+ * iOS Safari validation tools.
+ *
+ * Inspect viewport meta tags, safe-area insets, and PWA readiness —
+ * the three things every iOS Safari developer has to fight with.
+ */
+import { defineTool } from './types.js';
+function analyzeViewport(attrs) {
+    const issues = [];
+    if (Object.keys(attrs).length === 0) {
+        return [
+            {
+                severity: 'error',
+                message: 'No viewport meta tag found. iOS Safari will render at 980px width and scale down.',
+            },
+        ];
+    }
+    if (!attrs.width) {
+        issues.push({
+            severity: 'error',
+            message: 'Missing "width=device-width". Without this, Safari uses a default 980px layout width.',
+        });
+    }
+    else if (attrs.width !== 'device-width') {
+        issues.push({
+            severity: 'warning',
+            message: `width="${attrs.width}" — consider using "device-width" for responsive layouts.`,
+        });
+    }
+    if (!attrs['initial-scale']) {
+        issues.push({
+            severity: 'warning',
+            message: 'Missing "initial-scale=1". Some iOS Safari versions may not zoom correctly without it.',
+        });
+    }
+    if (attrs['user-scalable'] === 'no' || attrs['maximum-scale'] === '1') {
+        issues.push({
+            severity: 'error',
+            message: 'Zoom is disabled (user-scalable=no or maximum-scale=1). This is an accessibility violation (WCAG 1.4.4) and Safari 10+ ignores it anyway.',
+        });
+    }
+    if (attrs['viewport-fit'] !== 'cover') {
+        issues.push({
+            severity: 'warning',
+            message: 'Missing "viewport-fit=cover". Required for safe-area-inset-* CSS env() values to work on notched devices (iPhone X+).',
+        });
+    }
+    if (attrs['minimum-scale'] && parseFloat(attrs['minimum-scale']) < 1) {
+        issues.push({
+            severity: 'info',
+            message: `minimum-scale=${attrs['minimum-scale']}. Values below 1 allow zoom-out on iOS, which can cause layout issues.`,
+        });
+    }
+    return issues;
+}
+// ---- Tools ----
+export const tools = [
+    defineTool({
+        name: 'inspect_viewport_meta',
+        description: 'Parse the viewport meta tag and validate it against iOS Safari ' +
+            'best practices. Reports issues like missing width=device-width, ' +
+            'disabled zoom (accessibility violation), missing viewport-fit=cover ' +
+            'for safe areas, and other common misconfiguration.',
+        slimDescription: 'Validate iOS viewport meta tag.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        const meta = document.querySelector('meta[name="viewport"]');
+        if (!meta) return { content: null, attrs: {} };
+        const content = meta.getAttribute('content') || '';
+        const attrs = {};
+        for (const part of content.split(',')) {
+          const [key, val] = part.split('=').map(s => s.trim());
+          if (key) attrs[key] = val || '';
+        }
+        return { content, attrs };
+      })()`);
+            const issues = analyzeViewport(result.attrs);
+            const lines = [];
+            if (result.content) {
+                lines.push(`Viewport meta: ${result.content}`);
+            }
+            else {
+                lines.push('⚠ No <meta name="viewport"> tag found.');
+            }
+            lines.push('');
+            if (issues.length === 0) {
+                lines.push('✅ No issues found. Viewport is correctly configured for iOS Safari.');
+            }
+            else {
+                const errors = issues.filter(i => i.severity === 'error');
+                const warnings = issues.filter(i => i.severity === 'warning');
+                const infos = issues.filter(i => i.severity === 'info');
+                if (errors.length > 0) {
+                    lines.push('Errors:');
+                    for (const i of errors)
+                        lines.push(`  ❌ ${i.message}`);
+                }
+                if (warnings.length > 0) {
+                    lines.push('Warnings:');
+                    for (const i of warnings)
+                        lines.push(`  ⚠ ${i.message}`);
+                }
+                if (infos.length > 0) {
+                    lines.push('Info:');
+                    for (const i of infos)
+                        lines.push(`  ℹ ${i.message}`);
+                }
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+    defineTool({
+        name: 'get_safe_area_insets',
+        description: 'Read the current CSS safe-area-inset values (top, right, bottom, left) ' +
+            'as seen by the page. These are non-zero on notched iPhones when ' +
+            'viewport-fit=cover is set. Also checks whether the page uses ' +
+            'env(safe-area-inset-*) in its stylesheets.',
+        slimDescription: 'Get iOS safe area inset values.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        // Read computed env() values via a probe element
+        const probe = document.createElement('div');
+        probe.style.cssText =
+          'position:fixed;top:env(safe-area-inset-top,0px);' +
+          'right:env(safe-area-inset-right,0px);' +
+          'bottom:env(safe-area-inset-bottom,0px);' +
+          'left:env(safe-area-inset-left,0px);' +
+          'pointer-events:none;visibility:hidden;';
+        document.body.appendChild(probe);
+        const cs = getComputedStyle(probe);
+        const insets = {
+          top: cs.top, right: cs.right,
+          bottom: cs.bottom, left: cs.left,
+        };
+        probe.remove();
+
+        // Check viewport-fit=cover
+        const meta = document.querySelector('meta[name="viewport"]');
+        const viewportFitCover = meta
+          ? (meta.getAttribute('content') || '').includes('viewport-fit=cover')
+          : false;
+
+        // Scan stylesheets for env(safe-area-inset usage
+        let usedInCSS = false;
+        try {
+          for (const sheet of document.styleSheets) {
+            try {
+              const text = [...sheet.cssRules].map(r => r.cssText).join(' ');
+              if (text.includes('safe-area-inset')) { usedInCSS = true; break; }
+            } catch {}
+          }
+        } catch {}
+
+        return { insets, viewportFitCover, usedInCSS };
+      })()`);
+            const lines = ['Safe area insets:'];
+            lines.push(`  top: ${result.insets.top}`);
+            lines.push(`  right: ${result.insets.right}`);
+            lines.push(`  bottom: ${result.insets.bottom}`);
+            lines.push(`  left: ${result.insets.left}`);
+            lines.push('');
+            if (!result.viewportFitCover) {
+                lines.push('⚠ viewport-fit=cover is NOT set. Safe area insets will always be 0 ' +
+                    'even on notched devices. Add viewport-fit=cover to your viewport meta tag.');
+            }
+            else {
+                lines.push('✅ viewport-fit=cover is set.');
+            }
+            lines.push(result.usedInCSS
+                ? '✅ env(safe-area-inset-*) found in stylesheets.'
+                : '⚠ env(safe-area-inset-*) not found in any stylesheet. Content may be obscured by the notch/home indicator.');
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+    defineTool({
+        name: 'check_ios_web_app_readiness',
+        description: 'Audit the page for iOS Safari "Add to Home Screen" / PWA readiness. ' +
+            'Checks apple-touch-icon, apple-mobile-web-app-capable, status bar style, ' +
+            'theme-color, manifest link, and splash screen configuration.',
+        slimDescription: 'Audit iOS PWA/home screen readiness.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        const getMeta = (name) => {
+          const el = document.querySelector('meta[name="' + name + '"]');
+          return el ? el.getAttribute('content') : null;
+        };
+        const getLink = (rel) => {
+          const el = document.querySelector('link[rel="' + rel + '"]');
+          return el ? el.getAttribute('href') : null;
+        };
+
+        const touchIcons = [...document.querySelectorAll('link[rel="apple-touch-icon"]')].map(el => ({
+          sizes: el.getAttribute('sizes') || 'unspecified',
+          href: el.getAttribute('href') || '',
+        }));
+
+        const splashScreens = document.querySelectorAll('link[rel="apple-touch-startup-image"]').length;
+
+        return {
+          capable: getMeta('apple-mobile-web-app-capable'),
+          statusBarStyle: getMeta('apple-mobile-web-app-status-bar-style'),
+          themeColor: getMeta('theme-color'),
+          manifestHref: getLink('manifest'),
+          touchIcons,
+          title: document.title,
+          appleSplashScreens: splashScreens,
+        };
+      })()`);
+            const checks = [];
+            // apple-mobile-web-app-capable
+            checks.push({
+                pass: result.capable === 'yes',
+                label: 'apple-mobile-web-app-capable',
+                detail: result.capable === 'yes'
+                    ? 'Set to "yes" — app will run in standalone mode.'
+                    : 'Not set or not "yes". The app will open in Safari, not standalone.',
+            });
+            // apple-touch-icon
+            const has180 = result.touchIcons.some(i => i.sizes === '180x180');
+            checks.push({
+                pass: result.touchIcons.length > 0,
+                label: 'apple-touch-icon',
+                detail: result.touchIcons.length > 0
+                    ? `${result.touchIcons.length} icon(s): ${result.touchIcons.map(i => i.sizes).join(', ')}` +
+                        (has180 ? '' : '. ⚠ Missing 180x180 (recommended for iPhone).')
+                    : 'No apple-touch-icon found. iOS will use a screenshot as the icon.',
+            });
+            // theme-color
+            checks.push({
+                pass: result.themeColor !== null,
+                label: 'theme-color',
+                detail: result.themeColor !== null
+                    ? `Set to "${result.themeColor}".`
+                    : 'Not set. Safari 15+ uses theme-color for the tab bar tint.',
+            });
+            // status bar style
+            checks.push({
+                pass: result.statusBarStyle !== null,
+                label: 'apple-mobile-web-app-status-bar-style',
+                detail: result.statusBarStyle !== null
+                    ? `Set to "${result.statusBarStyle}".`
+                    : 'Not set. Defaults to "default" (black text on white). Consider "black-translucent" for full-screen feel.',
+            });
+            // manifest
+            checks.push({
+                pass: result.manifestHref !== null,
+                label: 'Web App Manifest',
+                detail: result.manifestHref !== null
+                    ? `Found: ${result.manifestHref}`
+                    : 'No <link rel="manifest"> found. Required for PWA install prompts.',
+            });
+            // splash screens
+            checks.push({
+                pass: result.appleSplashScreens > 0,
+                label: 'apple-touch-startup-image',
+                detail: result.appleSplashScreens > 0
+                    ? `${result.appleSplashScreens} splash screen(s) defined.`
+                    : 'No splash screens. Users will see a white screen while the app loads.',
+            });
+            const passed = checks.filter(c => c.pass).length;
+            const lines = [
+                `iOS Web App Readiness: ${passed}/${checks.length} checks passed`,
+                '',
+            ];
+            for (const c of checks) {
+                lines.push(`${c.pass ? '✅' : '❌'} ${c.label}`);
+                lines.push(`   ${c.detail}`);
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+];
+//# sourceMappingURL=ios-validation.js.map

package/build/src/tools/ios-validation.js.map

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

package/build/src/tools/webkit-compat.d.ts

@@ -0,0 +1,11 @@
+/**
+ * WebKit CSS compatibility checker.
+ *
+ * Scans stylesheets for known WebKit/Safari CSS issues:
+ *  - Properties that need -webkit- prefix in Safari
+ *  - Known WebKit rendering bugs with workarounds
+ *  - Deprecated -webkit- properties that should be removed
+ *  - Properties with different behavior in WebKit vs other engines
+ */
+export declare const tools: import("./types.js").ToolDef<import("zod").ZodRawShape>[];
+//# sourceMappingURL=webkit-compat.d.ts.map

package/build/src/tools/webkit-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webkit-compat.d.ts","sourceRoot":"","sources":["../../../src/tools/webkit-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiIH,eAAO,MAAM,KAAK,2DAyHjB,CAAC"}

package/build/src/tools/webkit-compat.js

@@ -0,0 +1,218 @@
+/**
+ * WebKit CSS compatibility checker.
+ *
+ * Scans stylesheets for known WebKit/Safari CSS issues:
+ *  - Properties that need -webkit- prefix in Safari
+ *  - Known WebKit rendering bugs with workarounds
+ *  - Deprecated -webkit- properties that should be removed
+ *  - Properties with different behavior in WebKit vs other engines
+ */
+import { defineTool } from './types.js';
+// Properties that still need -webkit- prefix in current Safari
+const NEEDS_PREFIX = {
+    'backdrop-filter': 'Safari requires -webkit-backdrop-filter. Unprefixed is supported only in Safari 18+.',
+    'text-decoration-skip-ink': 'Safari <18 needs -webkit-text-decoration-skip-ink.',
+    'line-clamp': 'Use -webkit-line-clamp with display: -webkit-box and -webkit-box-orient: vertical.',
+    'initial-letter': 'Safari requires -webkit-initial-letter.',
+    'text-stroke': 'Non-standard. Use -webkit-text-stroke (Safari-only feature).',
+    'background-clip: text': 'Safari requires -webkit-background-clip: text for text clipping.',
+    'touch-callout': 'iOS-only. Use -webkit-touch-callout: none to disable long-press popups.',
+    'overflow-scrolling': 'Use -webkit-overflow-scrolling: touch for momentum scrolling on iOS <15.',
+};
+// Known WebKit CSS bugs and quirks
+const KNOWN_QUIRKS = [
+    {
+        pattern: 'gap',
+        message: 'Flexbox "gap" is unsupported in Safari <14.1. Use margin-based spacing as fallback.',
+    },
+    {
+        pattern: 'position:\\s*sticky',
+        message: 'position:sticky inside overflow:hidden parents is broken in Safari. The sticky element will not stick.',
+    },
+    {
+        pattern: 'aspect-ratio',
+        message: 'aspect-ratio is unsupported in Safari <15. Use the padding-bottom hack as fallback.',
+    },
+    {
+        pattern: ':has\\(',
+        message: ':has() is supported in Safari 15.4+ but has performance edge cases with large DOM trees.',
+    },
+    {
+        pattern: 'container-type|@container',
+        message: 'Container queries require Safari 16+. No support in older iOS versions still in use.',
+    },
+    {
+        pattern: 'color-mix\\(',
+        message: 'color-mix() requires Safari 16.2+.',
+    },
+    {
+        pattern: '@layer',
+        message: '@layer (cascade layers) requires Safari 15.4+.',
+    },
+    {
+        pattern: 'subgrid',
+        message: 'subgrid requires Safari 16+.',
+    },
+    {
+        pattern: ':focus-visible',
+        message: ':focus-visible requires Safari 15.4+. Older versions need :focus fallback.',
+    },
+    {
+        pattern: 'overscroll-behavior',
+        message: 'overscroll-behavior requires Safari 16+. No effect on older iOS.',
+    },
+    {
+        pattern: 'dvh|svh|lvh',
+        message: 'Dynamic viewport units (dvh/svh/lvh) require Safari 15.4+. Use vh with JS fallback for older iOS.',
+    },
+    {
+        pattern: 'content-visibility',
+        message: 'content-visibility requires Safari 18+. Not supported in most iOS versions in the wild.',
+    },
+];
+// Deprecated -webkit- prefixes that can be removed
+const DEPRECATED_PREFIXES = [
+    {
+        prefix: '-webkit-border-radius',
+        standard: 'border-radius',
+        message: 'Unprefixed since Safari 5. Remove -webkit- prefix.',
+    },
+    {
+        prefix: '-webkit-box-shadow',
+        standard: 'box-shadow',
+        message: 'Unprefixed since Safari 5.1. Remove -webkit- prefix.',
+    },
+    {
+        prefix: '-webkit-transform',
+        standard: 'transform',
+        message: 'Unprefixed since Safari 9. Remove -webkit- prefix.',
+    },
+    {
+        prefix: '-webkit-transition',
+        standard: 'transition',
+        message: 'Unprefixed since Safari 9. Remove -webkit- prefix.',
+    },
+    {
+        prefix: '-webkit-animation',
+        standard: 'animation',
+        message: 'Unprefixed since Safari 9. Remove -webkit- prefix.',
+    },
+    {
+        prefix: '-webkit-flex',
+        standard: 'flex',
+        message: 'Unprefixed since Safari 9. Remove -webkit-flex and -webkit-box-flex.',
+    },
+    {
+        prefix: '-webkit-appearance',
+        standard: 'appearance',
+        message: 'Unprefixed since Safari 15.4. Keep prefix only if supporting older iOS.',
+    },
+    {
+        prefix: '-webkit-user-select',
+        standard: 'user-select',
+        message: 'Unprefixed since Safari 16.4. Keep prefix only if supporting older iOS.',
+    },
+];
+export const tools = [
+    defineTool({
+        name: 'check_webkit_compatibility',
+        description: 'Scan all stylesheets on the current page for WebKit/Safari CSS ' +
+            'compatibility issues. Reports: properties that need -webkit- prefix, ' +
+            'known WebKit rendering bugs, deprecated prefixes to clean up, and ' +
+            'modern CSS features with limited Safari support.',
+        slimDescription: 'Scan CSS for Safari compatibility issues.',
+        schema: {},
+        handler: async (_params, driver) => {
+            // Collect all CSS text from stylesheets
+            const cssText = await driver.runScript(`(() => {
+        const texts = [];
+        for (const sheet of document.styleSheets) {
+          try {
+            for (const rule of sheet.cssRules) {
+              texts.push(rule.cssText);
+            }
+          } catch {}
+        }
+        // Also check inline styles in style attributes
+        for (const el of document.querySelectorAll('[style]')) {
+          texts.push(el.getAttribute('style') || '');
+        }
+        return texts.join('\\n');
+      })()`);
+            if (!cssText || cssText.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No accessible stylesheets found. Cross-origin stylesheets cannot be inspected.',
+                        },
+                    ],
+                };
+            }
+            const findings = [];
+            // Check for properties needing -webkit- prefix
+            for (const [prop, message] of Object.entries(NEEDS_PREFIX)) {
+                const propPattern = prop.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                // Match as a CSS declaration (word boundary before, colon or space after)
+                // to avoid false positives on custom properties like --backdrop-filter
+                const declPattern = `(?<![\\w-])${propPattern}`;
+                if (new RegExp(`(?<!-webkit-)${declPattern}`, 'i').test(cssText) &&
+                    !new RegExp(`-webkit-${propPattern}`, 'i').test(cssText)) {
+                    findings.push({
+                        category: 'Missing prefix',
+                        severity: 'warning',
+                        message: `${prop}: ${message}`,
+                    });
+                }
+            }
+            // Check for known WebKit quirks
+            for (const quirk of KNOWN_QUIRKS) {
+                if (new RegExp(quirk.pattern, 'i').test(cssText)) {
+                    findings.push({
+                        category: 'Compatibility',
+                        severity: 'info',
+                        message: quirk.message,
+                    });
+                }
+            }
+            // Check for deprecated -webkit- prefixes
+            for (const dep of DEPRECATED_PREFIXES) {
+                if (cssText.includes(dep.prefix)) {
+                    findings.push({
+                        category: 'Deprecated prefix',
+                        severity: 'info',
+                        message: `${dep.prefix} → ${dep.standard}: ${dep.message}`,
+                    });
+                }
+            }
+            // Build output
+            const lines = [];
+            if (findings.length === 0) {
+                lines.push('✅ No WebKit CSS compatibility issues found in accessible stylesheets.');
+            }
+            else {
+                const warnings = findings.filter(f => f.severity === 'warning');
+                const infos = findings.filter(f => f.severity === 'info');
+                lines.push(`Found ${findings.length} issue(s) across accessible stylesheets:`);
+                lines.push('');
+                if (warnings.length > 0) {
+                    lines.push(`⚠ Action needed (${warnings.length}):`);
+                    for (const f of warnings) {
+                        lines.push(`  [${f.category}] ${f.message}`);
+                    }
+                    lines.push('');
+                }
+                if (infos.length > 0) {
+                    lines.push(`ℹ Informational (${infos.length}):`);
+                    for (const f of infos) {
+                        lines.push(`  [${f.category}] ${f.message}`);
+                    }
+                }
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+];
+//# sourceMappingURL=webkit-compat.js.map

package/build/src/tools/webkit-compat.js.map

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

package/build/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.0";
+export declare const VERSION = "1.8.0";
 //# sourceMappingURL=version.d.ts.map

package/build/src/version.js

@@ -1,4 +1,4 @@
 // x-release-please-start-version
-export const VERSION = '1.6.0';
+export const VERSION = '1.8.0';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "safari-devtools-mcp",
   "mcpName": "io.github.HayoDev/safari-devtools-mcp",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Safari DevTools MCP — real browser debugging with network interception, DOM inspection, cookie/storage management, and CSS analysis for AI agents on macOS",
   "type": "module",
   "main": "build/src/index.js",