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.
@@ -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"}
@@ -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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"}
@@ -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.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
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
+ }