viewprobe 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +248 -2
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +87 -0
- package/dist/cli.js.map +1 -0
- package/dist/cropper.d.ts +18 -0
- package/dist/cropper.d.ts.map +1 -0
- package/dist/cropper.js +53 -0
- package/dist/cropper.js.map +1 -0
- package/dist/engine.d.ts +10 -0
- package/dist/engine.d.ts.map +1 -0
- package/dist/engine.js +186 -0
- package/dist/engine.js.map +1 -0
- package/dist/formatter.d.ts +15 -0
- package/dist/formatter.d.ts.map +1 -0
- package/dist/formatter.js +95 -0
- package/dist/formatter.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/injector.d.ts +9 -0
- package/dist/injector.d.ts.map +1 -0
- package/dist/injector.js +165 -0
- package/dist/injector.js.map +1 -0
- package/dist/mcp-server.d.ts +13 -0
- package/dist/mcp-server.d.ts.map +1 -0
- package/dist/mcp-server.js +172 -0
- package/dist/mcp-server.js.map +1 -0
- package/dist/remediator.d.ts +15 -0
- package/dist/remediator.d.ts.map +1 -0
- package/dist/remediator.js +77 -0
- package/dist/remediator.js.map +1 -0
- package/dist/scanner.d.ts +27 -0
- package/dist/scanner.d.ts.map +1 -0
- package/dist/scanner.js +184 -0
- package/dist/scanner.js.map +1 -0
- package/dist/types.d.ts +58 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +13 -0
- package/dist/types.js.map +1 -0
- package/package.json +51 -4
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Browser-side scanning logic. Runs inside page context via page.evaluate().
|
|
3
|
+
* Walks the visible DOM and checks geometric properties for layout problems.
|
|
4
|
+
*/
|
|
5
|
+
export interface RawViolation {
|
|
6
|
+
type: string;
|
|
7
|
+
severity: "error" | "warning";
|
|
8
|
+
message: string;
|
|
9
|
+
selector: string;
|
|
10
|
+
bounds: {
|
|
11
|
+
x: number;
|
|
12
|
+
y: number;
|
|
13
|
+
width: number;
|
|
14
|
+
height: number;
|
|
15
|
+
};
|
|
16
|
+
styles: {
|
|
17
|
+
property: string;
|
|
18
|
+
value: string;
|
|
19
|
+
selector: string;
|
|
20
|
+
}[];
|
|
21
|
+
}
|
|
22
|
+
export declare function buildSelector(el: Element): string;
|
|
23
|
+
export declare function scanPage(options: {
|
|
24
|
+
skipSelectors?: string[];
|
|
25
|
+
targetSelectors?: string[];
|
|
26
|
+
}): RawViolation[];
|
|
27
|
+
//# sourceMappingURL=scanner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAqCjD;AAuBD,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,GAAG,YAAY,EAAE,CA+IjB"}
|
package/dist/scanner.js
ADDED
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Browser-side scanning logic. Runs inside page context via page.evaluate().
|
|
3
|
+
* Walks the visible DOM and checks geometric properties for layout problems.
|
|
4
|
+
*/
|
|
5
|
+
export function buildSelector(el) {
|
|
6
|
+
if (el.id)
|
|
7
|
+
return `#${el.id}`;
|
|
8
|
+
const parts = [];
|
|
9
|
+
let current = el;
|
|
10
|
+
while (current && current !== document.body && parts.length < 4) {
|
|
11
|
+
let segment = current.tagName.toLowerCase();
|
|
12
|
+
if (current.id) {
|
|
13
|
+
parts.unshift(`#${current.id}`);
|
|
14
|
+
break;
|
|
15
|
+
}
|
|
16
|
+
const parent = current.parentElement;
|
|
17
|
+
if (parent) {
|
|
18
|
+
const siblings = Array.from(parent.children).filter((c) => c.tagName === current.tagName);
|
|
19
|
+
if (siblings.length > 1) {
|
|
20
|
+
const idx = siblings.indexOf(current) + 1;
|
|
21
|
+
segment += `:nth-child(${idx})`;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
if (current.className && typeof current.className === "string") {
|
|
25
|
+
const cls = current.className.trim().split(/\s+/)[0];
|
|
26
|
+
if (cls && !cls.includes(":")) {
|
|
27
|
+
segment += `.${cls}`;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
parts.unshift(segment);
|
|
31
|
+
current = parent;
|
|
32
|
+
}
|
|
33
|
+
return parts.join(" > ");
|
|
34
|
+
}
|
|
35
|
+
function getStyles(el, props) {
|
|
36
|
+
const computed = window.getComputedStyle(el);
|
|
37
|
+
const sel = buildSelector(el);
|
|
38
|
+
return props.map((p) => ({
|
|
39
|
+
property: p,
|
|
40
|
+
value: computed.getPropertyValue(p),
|
|
41
|
+
selector: sel,
|
|
42
|
+
}));
|
|
43
|
+
}
|
|
44
|
+
function isVisible(el) {
|
|
45
|
+
const style = window.getComputedStyle(el);
|
|
46
|
+
if (style.display === "none" || style.visibility === "hidden")
|
|
47
|
+
return false;
|
|
48
|
+
if (parseFloat(style.opacity) === 0)
|
|
49
|
+
return false;
|
|
50
|
+
const rect = el.getBoundingClientRect();
|
|
51
|
+
return rect.width > 0 && rect.height > 0;
|
|
52
|
+
}
|
|
53
|
+
export function scanPage(options) {
|
|
54
|
+
const violations = [];
|
|
55
|
+
const vw = window.innerWidth;
|
|
56
|
+
let elements;
|
|
57
|
+
if (options.targetSelectors && options.targetSelectors.length > 0) {
|
|
58
|
+
elements = options.targetSelectors.flatMap((sel) => Array.from(document.querySelectorAll(sel)));
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
elements = Array.from(document.querySelectorAll("body *"));
|
|
62
|
+
}
|
|
63
|
+
const skipSet = new Set();
|
|
64
|
+
if (options.skipSelectors) {
|
|
65
|
+
for (const sel of options.skipSelectors) {
|
|
66
|
+
document.querySelectorAll(sel).forEach((el) => skipSet.add(el));
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
for (const el of elements) {
|
|
70
|
+
if (skipSet.has(el))
|
|
71
|
+
continue;
|
|
72
|
+
if (!isVisible(el))
|
|
73
|
+
continue;
|
|
74
|
+
const rect = el.getBoundingClientRect();
|
|
75
|
+
const bounds = {
|
|
76
|
+
x: Math.round(rect.x),
|
|
77
|
+
y: Math.round(rect.y),
|
|
78
|
+
width: Math.round(rect.width),
|
|
79
|
+
height: Math.round(rect.height),
|
|
80
|
+
};
|
|
81
|
+
// Horizontal overflow within container
|
|
82
|
+
if (el.scrollWidth > el.clientWidth + 2) {
|
|
83
|
+
const computed = window.getComputedStyle(el);
|
|
84
|
+
const overflowX = computed.overflowX;
|
|
85
|
+
const isEllipsis = computed.textOverflow === "ellipsis" && (overflowX === "hidden" || overflowX === "clip");
|
|
86
|
+
if (overflowX !== "auto" && overflowX !== "scroll" && !isEllipsis) {
|
|
87
|
+
violations.push({
|
|
88
|
+
type: "HORIZONTAL_OVERFLOW",
|
|
89
|
+
severity: "error",
|
|
90
|
+
message: `Element overflows its container horizontally by ${el.scrollWidth - el.clientWidth}px`,
|
|
91
|
+
selector: buildSelector(el),
|
|
92
|
+
bounds,
|
|
93
|
+
styles: getStyles(el, [
|
|
94
|
+
"width", "min-width", "max-width",
|
|
95
|
+
"overflow-x", "flex-shrink", "white-space",
|
|
96
|
+
]),
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
// Element extends beyond viewport
|
|
101
|
+
if (rect.right > vw + 1) {
|
|
102
|
+
violations.push({
|
|
103
|
+
type: "HORIZONTAL_OVERFLOW",
|
|
104
|
+
severity: "error",
|
|
105
|
+
message: `Element extends ${Math.round(rect.right - vw)}px beyond viewport edge`,
|
|
106
|
+
selector: buildSelector(el),
|
|
107
|
+
bounds,
|
|
108
|
+
styles: getStyles(el, [
|
|
109
|
+
"width", "min-width", "max-width",
|
|
110
|
+
"margin-right", "padding-right", "position", "right",
|
|
111
|
+
]),
|
|
112
|
+
});
|
|
113
|
+
}
|
|
114
|
+
// Text truncation without ellipsis
|
|
115
|
+
if (el.scrollWidth > el.clientWidth + 2 &&
|
|
116
|
+
el.children.length === 0 &&
|
|
117
|
+
(el.textContent?.trim().length ?? 0) > 0) {
|
|
118
|
+
const computed = window.getComputedStyle(el);
|
|
119
|
+
if (computed.textOverflow !== "ellipsis") {
|
|
120
|
+
violations.push({
|
|
121
|
+
type: "TEXT_TRUNCATION",
|
|
122
|
+
severity: "warning",
|
|
123
|
+
message: `Text is clipped without ellipsis — content overflows by ${el.scrollWidth - el.clientWidth}px`,
|
|
124
|
+
selector: buildSelector(el),
|
|
125
|
+
bounds,
|
|
126
|
+
styles: getStyles(el, [
|
|
127
|
+
"overflow", "text-overflow", "white-space", "max-width", "width",
|
|
128
|
+
]),
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
// Tap target sizing
|
|
133
|
+
const interactive = el.tagName === "A" ||
|
|
134
|
+
el.tagName === "BUTTON" ||
|
|
135
|
+
el.tagName === "INPUT" ||
|
|
136
|
+
el.tagName === "SELECT" ||
|
|
137
|
+
el.tagName === "TEXTAREA" ||
|
|
138
|
+
el.getAttribute("role") === "button" ||
|
|
139
|
+
el.getAttribute("tabindex") !== null;
|
|
140
|
+
if (interactive) {
|
|
141
|
+
const MIN_TAP = 44;
|
|
142
|
+
if (rect.width < MIN_TAP || rect.height < MIN_TAP) {
|
|
143
|
+
violations.push({
|
|
144
|
+
type: "TAP_TARGET_TOO_SMALL",
|
|
145
|
+
severity: "warning",
|
|
146
|
+
message: `Interactive element is ${Math.round(rect.width)}x${Math.round(rect.height)}px — minimum recommended is ${MIN_TAP}x${MIN_TAP}px`,
|
|
147
|
+
selector: buildSelector(el),
|
|
148
|
+
bounds,
|
|
149
|
+
styles: getStyles(el, [
|
|
150
|
+
"width", "height", "min-width", "min-height", "padding",
|
|
151
|
+
]),
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
// Body-level horizontal scroll
|
|
157
|
+
if (document.body.scrollWidth > window.innerWidth + 2) {
|
|
158
|
+
violations.push({
|
|
159
|
+
type: "HORIZONTAL_OVERFLOW",
|
|
160
|
+
severity: "error",
|
|
161
|
+
message: `Page has unwanted horizontal scroll — body is ${document.body.scrollWidth - window.innerWidth}px wider than viewport`,
|
|
162
|
+
selector: "body",
|
|
163
|
+
bounds: {
|
|
164
|
+
x: 0, y: 0,
|
|
165
|
+
width: document.body.scrollWidth,
|
|
166
|
+
height: document.body.scrollHeight,
|
|
167
|
+
},
|
|
168
|
+
styles: [
|
|
169
|
+
{
|
|
170
|
+
property: "overflow-x",
|
|
171
|
+
value: window.getComputedStyle(document.body).overflowX,
|
|
172
|
+
selector: "body",
|
|
173
|
+
},
|
|
174
|
+
{
|
|
175
|
+
property: "width",
|
|
176
|
+
value: `${document.body.scrollWidth}px (actual) vs ${window.innerWidth}px (viewport)`,
|
|
177
|
+
selector: "body",
|
|
178
|
+
},
|
|
179
|
+
],
|
|
180
|
+
});
|
|
181
|
+
}
|
|
182
|
+
return violations;
|
|
183
|
+
}
|
|
184
|
+
//# sourceMappingURL=scanner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
export interface Viewport {
|
|
2
|
+
name: string;
|
|
3
|
+
width: number;
|
|
4
|
+
height: number;
|
|
5
|
+
}
|
|
6
|
+
export interface BoundingBox {
|
|
7
|
+
x: number;
|
|
8
|
+
y: number;
|
|
9
|
+
width: number;
|
|
10
|
+
height: number;
|
|
11
|
+
}
|
|
12
|
+
export interface CulpritStyle {
|
|
13
|
+
property: string;
|
|
14
|
+
value: string;
|
|
15
|
+
selector: string;
|
|
16
|
+
}
|
|
17
|
+
export interface SuggestedFix {
|
|
18
|
+
css: string;
|
|
19
|
+
tailwind?: string;
|
|
20
|
+
explanation: string;
|
|
21
|
+
}
|
|
22
|
+
export type ViolationType = "HORIZONTAL_OVERFLOW" | "VERTICAL_OVERFLOW" | "ELEMENT_COLLISION" | "TEXT_TRUNCATION" | "TAP_TARGET_TOO_SMALL" | "TAP_TARGET_OVERLAP" | "INVISIBLE_CONTENT" | "ASPECT_RATIO_DISTORTION";
|
|
23
|
+
export interface LayoutViolation {
|
|
24
|
+
type: ViolationType;
|
|
25
|
+
severity: "error" | "warning";
|
|
26
|
+
viewport: Viewport;
|
|
27
|
+
message: string;
|
|
28
|
+
selector: string;
|
|
29
|
+
bounds: BoundingBox;
|
|
30
|
+
culpritStyles: CulpritStyle[];
|
|
31
|
+
microCrop?: string;
|
|
32
|
+
suggestedFix?: SuggestedFix;
|
|
33
|
+
}
|
|
34
|
+
export interface ProbeResult {
|
|
35
|
+
url: string;
|
|
36
|
+
timestamp: string;
|
|
37
|
+
duration: number;
|
|
38
|
+
viewportsChecked: Viewport[];
|
|
39
|
+
violations: LayoutViolation[];
|
|
40
|
+
passed: boolean;
|
|
41
|
+
summary: string;
|
|
42
|
+
}
|
|
43
|
+
export interface ProbeConfig {
|
|
44
|
+
url?: string;
|
|
45
|
+
filePath?: string;
|
|
46
|
+
html?: string;
|
|
47
|
+
viewports?: Viewport[];
|
|
48
|
+
selectors?: string[];
|
|
49
|
+
timeout?: number;
|
|
50
|
+
microCrops?: boolean;
|
|
51
|
+
cropPadding?: number;
|
|
52
|
+
cropQuality?: number;
|
|
53
|
+
waitForSelector?: string;
|
|
54
|
+
skipSelectors?: string[];
|
|
55
|
+
}
|
|
56
|
+
export declare const DEFAULT_VIEWPORTS: Viewport[];
|
|
57
|
+
export declare const DEFAULT_CONFIG: Partial<ProbeConfig>;
|
|
58
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,iBAAiB,EAAE,QAAQ,EAKvC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,WAAW,CAK/C,CAAC"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export const DEFAULT_VIEWPORTS = [
|
|
2
|
+
{ name: "mobile", width: 375, height: 812 },
|
|
3
|
+
{ name: "tablet", width: 768, height: 1024 },
|
|
4
|
+
{ name: "desktop", width: 1280, height: 900 },
|
|
5
|
+
{ name: "wide", width: 1920, height: 1080 },
|
|
6
|
+
];
|
|
7
|
+
export const DEFAULT_CONFIG = {
|
|
8
|
+
timeout: 10000,
|
|
9
|
+
microCrops: true,
|
|
10
|
+
cropPadding: 20,
|
|
11
|
+
cropQuality: 60,
|
|
12
|
+
};
|
|
13
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuEA,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAC3C,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAyB;IAClD,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,EAAE;CAChB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,53 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "viewprobe",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
6
|
-
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Headless layout verification engine for AI coding agents",
|
|
6
|
+
"main": "dist/index.js",
|
|
7
|
+
"types": "dist/index.d.ts",
|
|
8
|
+
"bin": {
|
|
9
|
+
"viewprobe": "dist/cli.js",
|
|
10
|
+
"viewprobe-mcp": "dist/mcp-server.js"
|
|
11
|
+
},
|
|
12
|
+
"files": [
|
|
13
|
+
"dist",
|
|
14
|
+
"README.md",
|
|
15
|
+
"LICENSE"
|
|
16
|
+
],
|
|
17
|
+
"scripts": {
|
|
18
|
+
"build": "tsc",
|
|
19
|
+
"dev": "tsc --watch",
|
|
20
|
+
"lint": "eslint src/",
|
|
21
|
+
"test": "vitest run",
|
|
22
|
+
"test:watch": "vitest",
|
|
23
|
+
"start": "node dist/cli.js",
|
|
24
|
+
"mcp": "node dist/mcp-server.js",
|
|
25
|
+
"prepublishOnly": "npm run build && npm test"
|
|
26
|
+
},
|
|
27
|
+
"keywords": [
|
|
28
|
+
"layout", "css", "verification", "ai-agents", "mcp",
|
|
29
|
+
"responsive", "headless", "testing", "developer-tools"
|
|
30
|
+
],
|
|
31
|
+
"author": "Umang Kumar",
|
|
32
|
+
"license": "MIT",
|
|
33
|
+
"repository": {
|
|
34
|
+
"type": "git",
|
|
35
|
+
"url": "git+https://github.com/Umang-sudo-su/ViewProbe.git"
|
|
36
|
+
},
|
|
37
|
+
"engines": {
|
|
38
|
+
"node": ">=20.0.0"
|
|
39
|
+
},
|
|
40
|
+
"dependencies": {
|
|
41
|
+
"playwright": "^1.49.0",
|
|
42
|
+
"commander": "^12.1.0",
|
|
43
|
+
"chalk": "^5.3.0"
|
|
44
|
+
},
|
|
45
|
+
"devDependencies": {
|
|
46
|
+
"typescript": "^5.6.0",
|
|
47
|
+
"@types/node": "^22.0.0",
|
|
48
|
+
"vitest": "^2.1.0",
|
|
49
|
+
"eslint": "^9.0.0",
|
|
50
|
+
"@typescript-eslint/eslint-plugin": "^8.0.0",
|
|
51
|
+
"@typescript-eslint/parser": "^8.0.0"
|
|
52
|
+
}
|
|
53
|
+
}
|