devlens-mcp 0.4.1 → 0.5.2

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.
Files changed (131) hide show
  1. package/README.md +211 -35
  2. package/RELEASE_NOTES.md +3 -7
  3. package/dist/bin/cli.js +47 -13
  4. package/dist/bin/cli.js.map +1 -1
  5. package/dist/bin/setup.d.ts +14 -0
  6. package/dist/bin/setup.d.ts.map +1 -0
  7. package/dist/bin/setup.js +272 -0
  8. package/dist/bin/setup.js.map +1 -0
  9. package/dist/src/figma/figma-api.d.ts +108 -0
  10. package/dist/src/figma/figma-api.d.ts.map +1 -0
  11. package/dist/src/figma/figma-api.js +284 -0
  12. package/dist/src/figma/figma-api.js.map +1 -0
  13. package/dist/src/figma/figma-cache.d.ts +57 -0
  14. package/dist/src/figma/figma-cache.d.ts.map +1 -0
  15. package/dist/src/figma/figma-cache.js +266 -0
  16. package/dist/src/figma/figma-cache.js.map +1 -0
  17. package/dist/src/figma/figma-client.d.ts +62 -0
  18. package/dist/src/figma/figma-client.d.ts.map +1 -0
  19. package/dist/src/figma/figma-client.js +224 -0
  20. package/dist/src/figma/figma-client.js.map +1 -0
  21. package/dist/src/figma/figma-rate-limiter.d.ts +46 -0
  22. package/dist/src/figma/figma-rate-limiter.d.ts.map +1 -0
  23. package/dist/src/figma/figma-rate-limiter.js +153 -0
  24. package/dist/src/figma/figma-rate-limiter.js.map +1 -0
  25. package/dist/src/figma/figma-retry.d.ts +19 -0
  26. package/dist/src/figma/figma-retry.d.ts.map +1 -0
  27. package/dist/src/figma/figma-retry.js +57 -0
  28. package/dist/src/figma/figma-retry.js.map +1 -0
  29. package/dist/src/figma/figma-structure.d.ts +1 -1
  30. package/dist/src/figma/figma-structure.d.ts.map +1 -1
  31. package/dist/src/figma/figma-structure.js +11 -1
  32. package/dist/src/figma/figma-structure.js.map +1 -1
  33. package/dist/src/figma/figma-types.d.ts +54 -0
  34. package/dist/src/figma/figma-types.d.ts.map +1 -0
  35. package/dist/src/figma/figma-types.js +33 -0
  36. package/dist/src/figma/figma-types.js.map +1 -0
  37. package/dist/src/figma/url-parser.d.ts +40 -0
  38. package/dist/src/figma/url-parser.d.ts.map +1 -0
  39. package/dist/src/figma/url-parser.js +107 -0
  40. package/dist/src/figma/url-parser.js.map +1 -0
  41. package/dist/src/platform/device-manager.d.ts +5 -0
  42. package/dist/src/platform/device-manager.d.ts.map +1 -1
  43. package/dist/src/platform/device-manager.js +18 -0
  44. package/dist/src/platform/device-manager.js.map +1 -1
  45. package/dist/src/platform/device-pool.d.ts +105 -0
  46. package/dist/src/platform/device-pool.d.ts.map +1 -0
  47. package/dist/src/platform/device-pool.js +328 -0
  48. package/dist/src/platform/device-pool.js.map +1 -0
  49. package/dist/src/platform/device-profiles.d.ts +50 -0
  50. package/dist/src/platform/device-profiles.d.ts.map +1 -0
  51. package/dist/src/platform/device-profiles.js +155 -0
  52. package/dist/src/platform/device-profiles.js.map +1 -0
  53. package/dist/src/platform/ios/ios-device.d.ts +0 -2
  54. package/dist/src/platform/ios/ios-device.d.ts.map +1 -1
  55. package/dist/src/platform/ios/ios-device.js +8 -18
  56. package/dist/src/platform/ios/ios-device.js.map +1 -1
  57. package/dist/src/platform/ios/simctl.d.ts +0 -5
  58. package/dist/src/platform/ios/simctl.d.ts.map +1 -1
  59. package/dist/src/platform/ios/simctl.js +0 -4
  60. package/dist/src/platform/ios/simctl.js.map +1 -1
  61. package/dist/src/platform/simulator-factory.d.ts +85 -0
  62. package/dist/src/platform/simulator-factory.d.ts.map +1 -0
  63. package/dist/src/platform/simulator-factory.js +396 -0
  64. package/dist/src/platform/simulator-factory.js.map +1 -0
  65. package/dist/src/platform/system-resources.d.ts +44 -0
  66. package/dist/src/platform/system-resources.d.ts.map +1 -0
  67. package/dist/src/platform/system-resources.js +103 -0
  68. package/dist/src/platform/system-resources.js.map +1 -0
  69. package/dist/src/prototype/browser-engine.d.ts +62 -0
  70. package/dist/src/prototype/browser-engine.d.ts.map +1 -0
  71. package/dist/src/prototype/browser-engine.js +199 -0
  72. package/dist/src/prototype/browser-engine.js.map +1 -0
  73. package/dist/src/prototype/figma-navigator.d.ts +40 -0
  74. package/dist/src/prototype/figma-navigator.d.ts.map +1 -0
  75. package/dist/src/prototype/figma-navigator.js +95 -0
  76. package/dist/src/prototype/figma-navigator.js.map +1 -0
  77. package/dist/src/prototype/flow-reporter.d.ts +47 -0
  78. package/dist/src/prototype/flow-reporter.d.ts.map +1 -0
  79. package/dist/src/prototype/flow-reporter.js +255 -0
  80. package/dist/src/prototype/flow-reporter.js.map +1 -0
  81. package/dist/src/prototype/screen-analyzer.d.ts +31 -0
  82. package/dist/src/prototype/screen-analyzer.d.ts.map +1 -0
  83. package/dist/src/prototype/screen-analyzer.js +114 -0
  84. package/dist/src/prototype/screen-analyzer.js.map +1 -0
  85. package/dist/src/prototype/web-crawler.d.ts +31 -0
  86. package/dist/src/prototype/web-crawler.d.ts.map +1 -0
  87. package/dist/src/prototype/web-crawler.js +88 -0
  88. package/dist/src/prototype/web-crawler.js.map +1 -0
  89. package/dist/src/reports/cross-device-report.d.ts +84 -0
  90. package/dist/src/reports/cross-device-report.d.ts.map +1 -0
  91. package/dist/src/reports/cross-device-report.js +342 -0
  92. package/dist/src/reports/cross-device-report.js.map +1 -0
  93. package/dist/src/server.d.ts.map +1 -1
  94. package/dist/src/server.js +9 -1
  95. package/dist/src/server.js.map +1 -1
  96. package/dist/src/snapshot/formatter.d.ts +5 -13
  97. package/dist/src/snapshot/formatter.d.ts.map +1 -1
  98. package/dist/src/snapshot/formatter.js +19 -28
  99. package/dist/src/snapshot/formatter.js.map +1 -1
  100. package/dist/src/tools/interaction-tools.d.ts +6 -6
  101. package/dist/src/tools/interaction-tools.d.ts.map +1 -1
  102. package/dist/src/tools/interaction-tools.js +2 -12
  103. package/dist/src/tools/interaction-tools.js.map +1 -1
  104. package/dist/src/tools/metro-tools.d.ts +2 -2
  105. package/dist/src/tools/multi-device-tools.d.ts +133 -0
  106. package/dist/src/tools/multi-device-tools.d.ts.map +1 -0
  107. package/dist/src/tools/multi-device-tools.js +365 -0
  108. package/dist/src/tools/multi-device-tools.js.map +1 -0
  109. package/dist/src/tools/navigation-tools.d.ts.map +1 -1
  110. package/dist/src/tools/navigation-tools.js +1 -6
  111. package/dist/src/tools/navigation-tools.js.map +1 -1
  112. package/dist/src/tools/prototype-tools.d.ts +102 -0
  113. package/dist/src/tools/prototype-tools.d.ts.map +1 -0
  114. package/dist/src/tools/prototype-tools.js +391 -0
  115. package/dist/src/tools/prototype-tools.js.map +1 -0
  116. package/dist/src/tools/screenshot-tools.d.ts +7 -74
  117. package/dist/src/tools/screenshot-tools.d.ts.map +1 -1
  118. package/dist/src/tools/screenshot-tools.js +19 -286
  119. package/dist/src/tools/screenshot-tools.js.map +1 -1
  120. package/dist/src/tools/vqa-tools.d.ts +2 -2
  121. package/dist/src/tools/vqa-tools.d.ts.map +1 -1
  122. package/dist/src/tools/vqa-tools.js +4 -69
  123. package/dist/src/tools/vqa-tools.js.map +1 -1
  124. package/docs/figma-workflow.md +58 -6
  125. package/docs/installation-guide.md +302 -0
  126. package/docs/setup-guide.md +77 -79
  127. package/docs/tool-reference.md +152 -69
  128. package/install.sh +119 -0
  129. package/package.json +5 -2
  130. package/setup.sh +320 -0
  131. package/tsconfig.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flow-reporter.js","sourceRoot":"","sources":["../../../src/prototype/flow-reporter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import { type DominantColor } from "../visual/color-extractor.js";
2
+ import type { DomMetadata, DomElement } from "./browser-engine.js";
3
+ export interface TypographyEntry {
4
+ text: string;
5
+ tag: string;
6
+ level: number;
7
+ }
8
+ export interface ComponentPattern {
9
+ type: string;
10
+ count: number;
11
+ examples: string[];
12
+ }
13
+ export interface ScreenAnalysis {
14
+ colorPalette: DominantColor[];
15
+ typography: TypographyEntry[];
16
+ components: ComponentPattern[];
17
+ interactiveElements: DomElement[];
18
+ navigationElements: Array<{
19
+ text: string;
20
+ href?: string;
21
+ }>;
22
+ scrollDepth: number;
23
+ sectionCount: number;
24
+ }
25
+ /**
26
+ * Analyse a single screen's screenshot and DOM metadata to extract
27
+ * colour palette, typography, component patterns, and interactive
28
+ * elements.
29
+ */
30
+ export declare function analyzeScreen(screenshot: Buffer, domMetadata: DomMetadata, scrollHeight?: number): Promise<ScreenAnalysis>;
31
+ //# sourceMappingURL=screen-analyzer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"screen-analyzer.d.ts","sourceRoot":"","sources":["../../../src/prototype/screen-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAClC,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAeD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,WAAW,EACxB,YAAY,GAAE,MAAU,GACvB,OAAO,CAAC,cAAc,CAAC,CAezB"}
@@ -0,0 +1,114 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.analyzeScreen = analyzeScreen;
4
+ const color_extractor_js_1 = require("../visual/color-extractor.js");
5
+ const NAV_KEYWORDS = [
6
+ "home",
7
+ "back",
8
+ "menu",
9
+ "nav",
10
+ "tab",
11
+ "photos",
12
+ "files",
13
+ "settings",
14
+ "profile",
15
+ "search",
16
+ ];
17
+ /**
18
+ * Analyse a single screen's screenshot and DOM metadata to extract
19
+ * colour palette, typography, component patterns, and interactive
20
+ * elements.
21
+ */
22
+ async function analyzeScreen(screenshot, domMetadata, scrollHeight = 0) {
23
+ const colorPalette = await extractColorPalette(screenshot);
24
+ const typography = extractTypography(domMetadata);
25
+ const components = detectComponentPatterns(domMetadata);
26
+ const navigationElements = detectNavigation(domMetadata);
27
+ return {
28
+ colorPalette,
29
+ typography,
30
+ components,
31
+ interactiveElements: domMetadata.interactiveElements,
32
+ navigationElements,
33
+ scrollDepth: scrollHeight,
34
+ sectionCount: domMetadata.headings.length,
35
+ };
36
+ }
37
+ async function extractColorPalette(screenshot) {
38
+ try {
39
+ const sharp = (await import("sharp")).default;
40
+ const { data, info } = await sharp(screenshot)
41
+ .resize(200, 400, { fit: "inside" })
42
+ .ensureAlpha()
43
+ .raw()
44
+ .toBuffer({ resolveWithObject: true });
45
+ return (0, color_extractor_js_1.extractDominantColors)(data, info.width, info.height, 8);
46
+ }
47
+ catch {
48
+ return [];
49
+ }
50
+ }
51
+ function extractTypography(dom) {
52
+ return dom.headings.map((text, idx) => {
53
+ const level = idx < 1 ? 1 : idx < 3 ? 2 : 3;
54
+ const tag = `h${level}`;
55
+ return { text, tag, level };
56
+ });
57
+ }
58
+ function detectComponentPatterns(dom) {
59
+ const patterns = [];
60
+ const tagCounts = new Map();
61
+ for (const el of dom.interactiveElements) {
62
+ const list = tagCounts.get(el.tag) || [];
63
+ list.push(el.text);
64
+ tagCounts.set(el.tag, list);
65
+ }
66
+ if (dom.images.length > 2) {
67
+ patterns.push({
68
+ type: "image-gallery",
69
+ count: dom.images.length,
70
+ examples: dom.images.slice(0, 3).map((i) => i.alt || i.src.slice(0, 60)),
71
+ });
72
+ }
73
+ const buttons = tagCounts.get("button") || [];
74
+ if (buttons.length > 0) {
75
+ patterns.push({
76
+ type: "button",
77
+ count: buttons.length,
78
+ examples: buttons.slice(0, 3),
79
+ });
80
+ }
81
+ const linkTexts = dom.links.map((l) => l.text).filter(Boolean);
82
+ const seeAllLinks = linkTexts.filter((t) => t.toLowerCase().includes("see all") || t.toLowerCase().includes("view all"));
83
+ if (seeAllLinks.length > 0) {
84
+ patterns.push({
85
+ type: "section-with-see-all",
86
+ count: seeAllLinks.length,
87
+ examples: seeAllLinks.slice(0, 3),
88
+ });
89
+ }
90
+ const tabLikeLinks = dom.interactiveElements.filter((el) => el.role === "tab" ||
91
+ (el.tag === "a" &&
92
+ el.bounds.height > 0 &&
93
+ el.bounds.height < 60 &&
94
+ el.bounds.width < 200));
95
+ if (tabLikeLinks.length >= 3) {
96
+ patterns.push({
97
+ type: "tab-bar",
98
+ count: tabLikeLinks.length,
99
+ examples: tabLikeLinks.slice(0, 5).map((el) => el.text),
100
+ });
101
+ }
102
+ return patterns;
103
+ }
104
+ function detectNavigation(dom) {
105
+ const navItems = [];
106
+ for (const el of dom.interactiveElements) {
107
+ const lower = el.text.toLowerCase();
108
+ if (NAV_KEYWORDS.some((kw) => lower.includes(kw))) {
109
+ navItems.push({ text: el.text, href: el.href });
110
+ }
111
+ }
112
+ return navItems;
113
+ }
114
+ //# sourceMappingURL=screen-analyzer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"screen-analyzer.js","sourceRoot":"","sources":["../../../src/prototype/screen-analyzer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import { BrowserEngine, type DomMetadata } from "./browser-engine.js";
2
+ export interface ScrollCapture {
3
+ scrollY: number;
4
+ screenshot: Buffer;
5
+ }
6
+ export interface CrawlResult {
7
+ url: string;
8
+ path: string;
9
+ screenshot: Buffer;
10
+ scrollCaptures: ScrollCapture[];
11
+ domMetadata: DomMetadata;
12
+ }
13
+ export interface WebCrawlerOptions {
14
+ maxPages: number;
15
+ scrollCapture: boolean;
16
+ captureDelay: number;
17
+ viewportWidth: number;
18
+ viewportHeight: number;
19
+ }
20
+ /**
21
+ * BFS web-crawler that discovers same-origin routes, scrolls each page,
22
+ * captures screenshots, and extracts DOM metadata.
23
+ */
24
+ export declare class WebCrawler {
25
+ private readonly engine;
26
+ private readonly options;
27
+ constructor(engine: BrowserEngine, options: WebCrawlerOptions);
28
+ crawl(startUrl: string): Promise<CrawlResult[]>;
29
+ private captureScrollSections;
30
+ }
31
+ //# sourceMappingURL=web-crawler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-crawler.d.ts","sourceRoot":"","sources":["../../../src/prototype/web-crawler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAcD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB;IAKvD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YA8CvC,qBAAqB;CAqBpC"}
@@ -0,0 +1,88 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.WebCrawler = void 0;
4
+ const SCROLL_STEP = 600;
5
+ function normalizePath(url, baseOrigin) {
6
+ try {
7
+ const u = new URL(url);
8
+ if (u.origin !== baseOrigin)
9
+ return "";
10
+ return u.pathname.replace(/\/+$/, "") || "/";
11
+ }
12
+ catch {
13
+ return "";
14
+ }
15
+ }
16
+ /**
17
+ * BFS web-crawler that discovers same-origin routes, scrolls each page,
18
+ * captures screenshots, and extracts DOM metadata.
19
+ */
20
+ class WebCrawler {
21
+ engine;
22
+ options;
23
+ constructor(engine, options) {
24
+ this.engine = engine;
25
+ this.options = options;
26
+ }
27
+ async crawl(startUrl) {
28
+ const baseOrigin = new URL(startUrl).origin;
29
+ const visited = new Set();
30
+ const queue = [startUrl];
31
+ const results = [];
32
+ while (queue.length > 0 && results.length < this.options.maxPages) {
33
+ const url = queue.shift();
34
+ const path = normalizePath(url, baseOrigin);
35
+ if (!path || visited.has(path))
36
+ continue;
37
+ visited.add(path);
38
+ try {
39
+ await this.engine.navigate(url);
40
+ await this.engine.waitMs(this.options.captureDelay);
41
+ const screenshot = await this.engine.screenshot();
42
+ const domMetadata = await this.engine.extractDomMetadata();
43
+ const scrollCaptures = this.options.scrollCapture
44
+ ? await this.captureScrollSections()
45
+ : [];
46
+ results.push({
47
+ url: await this.engine.currentUrl(),
48
+ path,
49
+ screenshot,
50
+ scrollCaptures,
51
+ domMetadata,
52
+ });
53
+ const links = await this.engine.extractLinks();
54
+ for (const link of links) {
55
+ const linkPath = normalizePath(link.href, baseOrigin);
56
+ if (linkPath && !visited.has(linkPath)) {
57
+ queue.push(link.href);
58
+ }
59
+ }
60
+ }
61
+ catch (err) {
62
+ const msg = err instanceof Error ? err.message : String(err);
63
+ console.error(`[devlens] Failed to crawl ${url}: ${msg}`);
64
+ }
65
+ }
66
+ return results;
67
+ }
68
+ async captureScrollSections() {
69
+ const captures = [];
70
+ const scrollHeight = await this.engine.getScrollHeight();
71
+ const viewportHeight = this.options.viewportHeight;
72
+ let currentScroll = 0;
73
+ while (currentScroll + viewportHeight < scrollHeight) {
74
+ await this.engine.scrollPage("down", SCROLL_STEP);
75
+ await this.engine.waitMs(300);
76
+ currentScroll = await this.engine.getScrollPosition();
77
+ captures.push({
78
+ scrollY: currentScroll,
79
+ screenshot: await this.engine.viewportScreenshot(),
80
+ });
81
+ if (captures.length >= 10)
82
+ break;
83
+ }
84
+ return captures;
85
+ }
86
+ }
87
+ exports.WebCrawler = WebCrawler;
88
+ //# sourceMappingURL=web-crawler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-crawler.js","sourceRoot":"","sources":["../../../src/prototype/web-crawler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * Cross-device comparison report generator.
3
+ *
4
+ * Takes captured data from multiple devices and produces:
5
+ * - Pairwise pixel similarity matrix
6
+ * - Layout consistency analysis (missing elements per device)
7
+ * - Responsive issue detection
8
+ * - Optional per-device Figma comparison
9
+ */
10
+ import type { CapturedDeviceData } from "../platform/device-pool.js";
11
+ export interface CrossDeviceReport {
12
+ devices: Array<{
13
+ id: string;
14
+ name: string;
15
+ category: string;
16
+ platform: string;
17
+ resolution: string;
18
+ }>;
19
+ /** Pairwise pixel similarity between devices (0-1) */
20
+ pixelMatrix: Array<{
21
+ deviceA: string;
22
+ deviceB: string;
23
+ similarity: number;
24
+ }>;
25
+ /** Layout consistency across devices */
26
+ layoutConsistency: {
27
+ /** Elements present on ALL devices */
28
+ commonElements: number;
29
+ /** Total unique elements across all devices */
30
+ totalUniqueElements: number;
31
+ /** Elements missing on some devices */
32
+ missingElements: Array<{
33
+ text: string;
34
+ type: string;
35
+ presentOn: string[];
36
+ missingOn: string[];
37
+ severity: "critical" | "warning";
38
+ likelyCause: string;
39
+ }>;
40
+ /** Structural differences between devices */
41
+ structureDifferences: Array<{
42
+ path: string;
43
+ property: string;
44
+ values: Record<string, string>;
45
+ severity: "critical" | "warning";
46
+ }>;
47
+ };
48
+ /** Per-device Figma comparison (if Figma screenshot provided) */
49
+ figmaComparison?: Array<{
50
+ deviceId: string;
51
+ deviceName: string;
52
+ pixelMatch: number;
53
+ bestMatch: boolean;
54
+ }>;
55
+ /** Detected responsive issues */
56
+ responsiveIssues: Array<{
57
+ issue: string;
58
+ affectedDevices: string[];
59
+ severity: "critical" | "warning" | "info";
60
+ suggestion: string;
61
+ }>;
62
+ /** System info for the report header */
63
+ systemInfo: {
64
+ totalRAM: string;
65
+ strategy: string;
66
+ totalTimeMs: number;
67
+ };
68
+ summary: string;
69
+ }
70
+ /**
71
+ * Generate a full cross-device comparison report from captured data.
72
+ */
73
+ export declare function generateCrossDeviceReport(captures: CapturedDeviceData[], options?: {
74
+ figmaScreenshot?: Buffer;
75
+ pixelThreshold?: number;
76
+ strategy?: string;
77
+ totalTimeMs?: number;
78
+ totalRAM?: string;
79
+ }): Promise<CrossDeviceReport>;
80
+ /**
81
+ * Format the cross-device report as human-readable text.
82
+ */
83
+ export declare function formatCrossDeviceReport(report: CrossDeviceReport): string;
84
+ //# sourceMappingURL=cross-device-report.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cross-device-report.d.ts","sourceRoot":"","sources":["../../../src/reports/cross-device-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAMrE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAEH,sDAAsD;IACtD,WAAW,EAAE,KAAK,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAEH,wCAAwC;IACxC,iBAAiB,EAAE;QACjB,sCAAsC;QACtC,cAAc,EAAE,MAAM,CAAC;QACvB,+CAA+C;QAC/C,mBAAmB,EAAE,MAAM,CAAC;QAC5B,uCAAuC;QACvC,eAAe,EAAE,KAAK,CAAC;YACrB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,EAAE,CAAC;YACpB,SAAS,EAAE,MAAM,EAAE,CAAC;YACpB,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;YACjC,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,6CAA6C;QAC7C,oBAAoB,EAAE,KAAK,CAAC;YAC1B,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;SAClC,CAAC,CAAC;KACJ,CAAC;IAEF,iEAAiE;IACjE,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH,iCAAiC;IACjC,gBAAgB,EAAE,KAAK,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAEH,wCAAwC;IACxC,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,OAAO,CAAC,iBAAiB,CAAC,CA4D5B;AAgSD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAyGzE"}