@xysfe/bug-tap 0.0.0-stage → 0.1.1

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 (76) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/LICENSE +21 -0
  3. package/README.md +461 -2
  4. package/THIRD_PARTY_NOTICES.md +39 -0
  5. package/dist/bug-tap-screenshot.min.js +10 -0
  6. package/dist/bug-tap-screenshot.min.js.map +1 -0
  7. package/dist/bug-tap-vue.cjs +2 -0
  8. package/dist/bug-tap-vue.cjs.map +1 -0
  9. package/dist/bug-tap-vue.js +106 -0
  10. package/dist/bug-tap-vue.js.map +1 -0
  11. package/dist/bug-tap-vue.min.js +2 -0
  12. package/dist/bug-tap-vue.min.js.map +1 -0
  13. package/dist/bug-tap.cjs +2 -0
  14. package/dist/bug-tap.cjs.map +1 -0
  15. package/dist/bug-tap.js +13 -0
  16. package/dist/bug-tap.js.map +1 -0
  17. package/dist/bug-tap.min.js +508 -0
  18. package/dist/bug-tap.min.js.map +1 -0
  19. package/dist/config.d.ts +14 -0
  20. package/dist/core/body.d.ts +30 -0
  21. package/dist/core/breadcrumbs.d.ts +85 -0
  22. package/dist/core/browser-api-errors.d.ts +55 -0
  23. package/dist/core/byte-buffer.d.ts +43 -0
  24. package/dist/core/collector.d.ts +34 -0
  25. package/dist/core/console-collector.d.ts +23 -0
  26. package/dist/core/env-collector.d.ts +16 -0
  27. package/dist/core/error-collector.d.ts +48 -0
  28. package/dist/core/error-noise.d.ts +43 -0
  29. package/dist/core/network-collector.d.ts +97 -0
  30. package/dist/core/network-record.d.ts +19 -0
  31. package/dist/core/resource-timing.d.ts +28 -0
  32. package/dist/core/ring-buffer.d.ts +22 -0
  33. package/dist/core/selector.d.ts +3 -0
  34. package/dist/core/serialize.d.ts +5 -0
  35. package/dist/core/tongji.d.ts +14 -0
  36. package/dist/core/user.d.ts +9 -0
  37. package/dist/index-BbRyzCzY.cjs +488 -0
  38. package/dist/index-BbRyzCzY.cjs.map +1 -0
  39. package/dist/index-D_ygxzgY.js +4685 -0
  40. package/dist/index-D_ygxzgY.js.map +1 -0
  41. package/dist/index.d.ts +33 -0
  42. package/dist/integrations.d.ts +26 -0
  43. package/dist/panel-mount-BOOHHmMb.js +499 -0
  44. package/dist/panel-mount-BOOHHmMb.js.map +1 -0
  45. package/dist/panel-mount-CjRBibNV.cjs +2 -0
  46. package/dist/panel-mount-CjRBibNV.cjs.map +1 -0
  47. package/dist/screenshot-global.d.ts +14 -0
  48. package/dist/sdk.d.ts +76 -0
  49. package/dist/transport/log-item.d.ts +2 -0
  50. package/dist/transport/offline-queue.d.ts +48 -0
  51. package/dist/transport/payload.d.ts +15 -0
  52. package/dist/transport/transport.d.ts +57 -0
  53. package/dist/transport/upload.d.ts +8 -0
  54. package/dist/types.d.ts +459 -0
  55. package/dist/ui/element-picker.d.ts +51 -0
  56. package/dist/ui/floating-button.d.ts +43 -0
  57. package/dist/ui/icons.d.ts +1 -0
  58. package/dist/ui/panel-mount.d.ts +20 -0
  59. package/dist/ui/panel.vue.d.ts +15 -0
  60. package/dist/ui/screenshot-loader-shared.d.ts +2 -0
  61. package/dist/ui/screenshot-loader.d.ts +14 -0
  62. package/dist/ui/screenshot-loader.iife.d.ts +16 -0
  63. package/dist/ui/screenshot.d.ts +20 -0
  64. package/dist/ui/shadow-host.d.ts +16 -0
  65. package/dist/ui/styles.css.d.ts +1 -0
  66. package/dist/ui/visibility.d.ts +25 -0
  67. package/dist/utils/match.d.ts +2 -0
  68. package/dist/utils/ua.d.ts +6 -0
  69. package/dist/utils/url.d.ts +2 -0
  70. package/dist/vue-global.d.ts +21 -0
  71. package/dist/vue.d.ts +49 -0
  72. package/docs/api.md +257 -0
  73. package/docs/backend-api.md +401 -0
  74. package/docs/bundler.md +122 -0
  75. package/docs/config.md +396 -0
  76. package/package.json +97 -4
@@ -0,0 +1,459 @@
1
+ export type LogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug' | 'trace' | 'assert';
2
+ export interface ConsoleLog {
3
+ level: LogLevel;
4
+ timestamp: number;
5
+ args: string[];
6
+ text: string;
7
+ count?: number;
8
+ }
9
+ export interface JavaScriptError {
10
+ type: 'error' | 'unhandledrejection' | 'resource';
11
+ message: string;
12
+ filename?: string;
13
+ lineno?: number;
14
+ colno?: number;
15
+ stack?: string;
16
+ cause?: string;
17
+ context?: Record<string, unknown>;
18
+ timestamp: number;
19
+ count: number;
20
+ }
21
+ export interface Breadcrumb {
22
+ t: number;
23
+ type: 'click' | 'route' | 'visibility' | 'input' | 'http' | 'error' | 'manual';
24
+ selector?: string;
25
+ text?: string;
26
+ from?: string;
27
+ to?: string;
28
+ state?: string;
29
+ method?: string;
30
+ url?: string;
31
+ status?: number;
32
+ durationMs?: number;
33
+ ref?: string;
34
+ repeat?: number;
35
+ message?: string;
36
+ count?: number;
37
+ httpError?: string;
38
+ data?: Record<string, unknown>;
39
+ }
40
+ export interface CollectorHealth {
41
+ startedAt: number;
42
+ earlyGapMs: number;
43
+ patched: {
44
+ console: boolean;
45
+ fetch: boolean;
46
+ xhr: boolean;
47
+ error: boolean;
48
+ websocket?: boolean;
49
+ eventsource?: boolean;
50
+ };
51
+ counts: {
52
+ logs: number;
53
+ errors: number;
54
+ network: number;
55
+ breadcrumbs: number;
56
+ };
57
+ breadcrumbLimit?: number;
58
+ breadcrumbEvicted?: number;
59
+ }
60
+ export interface AppInfo {
61
+ version?: string;
62
+ buildId?: string;
63
+ }
64
+ export interface NetworkRecord {
65
+ id: string;
66
+ type: 'fetch' | 'xhr' | 'websocket' | 'eventsource';
67
+ method: string;
68
+ url: string;
69
+ status?: number;
70
+ ok?: boolean;
71
+ durationMs?: number;
72
+ error?: string;
73
+ reqBody?: string;
74
+ resBody?: string;
75
+ contentType?: string;
76
+ reqHeaders?: Record<string, string>;
77
+ resHeaders?: Record<string, string>;
78
+ timing?: NetworkTiming;
79
+ timestamp: number;
80
+ }
81
+ export interface NetworkTiming {
82
+ dns: number;
83
+ connect: number;
84
+ ttfb: number;
85
+ download: number;
86
+ total: number;
87
+ }
88
+ export interface Screenshot {
89
+ mime: string;
90
+ dataBase64?: string;
91
+ url?: string;
92
+ width: number;
93
+ height: number;
94
+ size: number;
95
+ source: 'auto' | 'manual';
96
+ capturedAt?: number;
97
+ }
98
+ export interface BrowserInfo {
99
+ userAgent: string;
100
+ platform?: string;
101
+ browser?: string;
102
+ browserVersion?: string;
103
+ os?: string;
104
+ screenWidth: number;
105
+ screenHeight: number;
106
+ viewportWidth: number;
107
+ viewportHeight: number;
108
+ dpr: number;
109
+ device?: string;
110
+ language: string;
111
+ timezone: string;
112
+ }
113
+ export interface PageInfo {
114
+ url: string;
115
+ referrer?: string;
116
+ title?: string;
117
+ }
118
+ export interface LogItem {
119
+ timestamp: number;
120
+ logLevel: 1 | 2 | 3;
121
+ userAgent: string;
122
+ url: string;
123
+ content: string;
124
+ traceId: string;
125
+ ext: string;
126
+ }
127
+ export interface LogReportResponse {
128
+ errCode: number;
129
+ errMsg?: string;
130
+ }
131
+ export interface ElementSnapshot {
132
+ selector: string;
133
+ tag: string;
134
+ text?: string;
135
+ attributes: Record<string, string>;
136
+ rect: {
137
+ x: number;
138
+ y: number;
139
+ width: number;
140
+ height: number;
141
+ };
142
+ path: string;
143
+ }
144
+ export interface NetworkDropped {
145
+ droppedCount: number;
146
+ droppedBytes: number;
147
+ evictedCount: number;
148
+ evictedBytes: number;
149
+ trimmedCount?: number;
150
+ totalCount: number | null;
151
+ sentCount: number;
152
+ }
153
+ export interface TrackIds {
154
+ xid?: string;
155
+ subId?: string;
156
+ sessionId?: string;
157
+ }
158
+ export interface BugReport {
159
+ project: string;
160
+ environment: string;
161
+ title: string;
162
+ description: string;
163
+ category?: string;
164
+ severity?: string;
165
+ contact?: string;
166
+ user?: UserInfo;
167
+ track?: TrackIds;
168
+ page: PageInfo;
169
+ browser: BrowserInfo;
170
+ logs: ConsoleLog[];
171
+ errors: JavaScriptError[];
172
+ network: NetworkRecord[];
173
+ screenshots?: Screenshot[];
174
+ elements?: ElementSnapshot[];
175
+ networkDropped?: NetworkDropped;
176
+ breadcrumbs?: Breadcrumb[];
177
+ collector?: CollectorHealth;
178
+ app?: AppInfo;
179
+ release?: string;
180
+ tags?: Record<string, string | number | boolean>;
181
+ extra?: Record<string, unknown>;
182
+ contexts?: Record<string, Record<string, unknown>>;
183
+ timestamp: number;
184
+ sdkVersion: string;
185
+ clientReportId: string;
186
+ }
187
+ export interface ReporterFormValues {
188
+ title: string;
189
+ description: string;
190
+ category?: string;
191
+ severity?: string;
192
+ contact?: string;
193
+ }
194
+ export interface SubmitResponse {
195
+ success: boolean;
196
+ reportId?: string;
197
+ message?: string;
198
+ queued?: boolean;
199
+ }
200
+ export interface AttachmentRef {
201
+ id: string;
202
+ url?: string;
203
+ }
204
+ export interface UserInfo {
205
+ id?: string;
206
+ name?: string;
207
+ [key: string]: string | number | boolean | undefined;
208
+ }
209
+ export type UserInfoInput = UserInfo | (() => UserInfo | null | undefined);
210
+ export interface ReporterUiConfig {
211
+ enabled?: boolean;
212
+ position?: 'bottom-right' | 'bottom-left';
213
+ theme?: 'light' | 'dark' | 'auto';
214
+ text?: string;
215
+ zIndex?: number;
216
+ visibility?: {
217
+ mode?: 'always' | 'triggered';
218
+ queryParam?: string;
219
+ queryValue?: string;
220
+ closable?: boolean;
221
+ };
222
+ }
223
+ export interface CollectConfig {
224
+ console?: boolean;
225
+ error?: boolean;
226
+ network?: boolean;
227
+ networkBody?: boolean;
228
+ realtime?: boolean;
229
+ resourceErrors?: boolean;
230
+ environment?: boolean;
231
+ trackIds?: boolean;
232
+ breadcrumbs?: boolean;
233
+ maxBreadcrumbs?: number;
234
+ maxConsoleLogs?: number;
235
+ maxNetworkRecords?: number;
236
+ maxErrors?: number;
237
+ maxNetworkBytes?: number;
238
+ maxCloneBytes?: number;
239
+ requestHeaders?: string[] | boolean;
240
+ responseHeaders?: string[] | boolean;
241
+ maxElements?: number;
242
+ eventListenerErrors?: boolean;
243
+ }
244
+ export interface PrivacyConfig {
245
+ excludeUrls?: Array<string | RegExp>;
246
+ excludeConsolePatterns?: Array<string | RegExp>;
247
+ excludeBreadcrumbUrls?: Array<string | RegExp>;
248
+ }
249
+ /**
250
+ * 错误噪声过滤,语义对齐 Sentry 的 eventFilters:
251
+ * - ignoreErrors:消息命中即不采(字符串按包含,正则按 test)
252
+ * - denyUrls / allowUrls:按异常栈里**抛出点脚本的地址**过滤,不是页面地址
253
+ */
254
+ export interface FilteringConfig {
255
+ ignoreErrors?: Array<string | RegExp>;
256
+ denyUrls?: Array<string | RegExp>;
257
+ allowUrls?: Array<string | RegExp>;
258
+ disableErrorDefaults?: boolean;
259
+ }
260
+ /**
261
+ * 业务侧介入点,语义对齐 Sentry 的 beforeSend / beforeBreadcrumb:
262
+ * 返回 null 表示丢弃这条数据,返回值替换原数据。
263
+ * 抛错时按「不修改」处理,绝不阻断上报。
264
+ */
265
+ export interface HooksConfig {
266
+ beforeSend?: (report: BugReport) => BugReport | null | Promise<BugReport | null>;
267
+ beforeBreadcrumb?: (breadcrumb: Breadcrumb) => Breadcrumb | null;
268
+ }
269
+ /** 网络响应头白名单:这些头能让前端报告与后端日志对上号 */
270
+ export declare const TRACE_HEADER_NAMES: readonly ["x-request-id", "x-trace-id", "traceparent", "tracestate", "x-b3-traceid", "x-b3-spanid", "server-timing", "content-length"];
271
+ export interface ScreenshotConfig {
272
+ enabled?: boolean;
273
+ auto?: boolean;
274
+ quality?: number;
275
+ maxWidth?: number;
276
+ maxSizeKB?: number;
277
+ /**
278
+ * CDN 场景下 `bug-tap-screenshot.min.js` 的地址。
279
+ *
280
+ * 不填时按「与主包同目录」推断,适用于整包一起部署到 CDN 的情况。
281
+ * 以下场景必须显式指定:
282
+ * - 主包与截图库不在同一目录(如截图库单独走另一条 CDN / 版本号路径)
283
+ * - 主包经内联或 `/assets/xxx.js` 之类的动态文件名加载,推断不到原始 URL
284
+ * - 主包由打包器打进业务 chunk,`document.currentScript` 指向业务入口
285
+ *
286
+ * 支持相对路径(按当前页面解析)与绝对 URL。
287
+ * 两种产物都生效:ESM 下配了它就不再 `import('html2canvas-pro')`,改为注入外部脚本。
288
+ */
289
+ scriptUrl?: string;
290
+ }
291
+ export interface TransportConfig {
292
+ timeoutMs?: number;
293
+ retries?: number;
294
+ headers?: Record<string, string>;
295
+ maxItemBytes?: number;
296
+ totalTimeoutMs?: number;
297
+ maxConcurrent?: number;
298
+ logLevel?: 1 | 2 | 3;
299
+ offline?: {
300
+ enabled?: boolean;
301
+ ttlMs?: number;
302
+ maxItems?: number;
303
+ };
304
+ maxReportsPerSession?: number;
305
+ }
306
+ export interface UploadConfig {
307
+ enabled?: boolean;
308
+ url?: string;
309
+ bizId?: string;
310
+ timeoutMs?: number;
311
+ }
312
+ export interface BugTapConfig {
313
+ project: string;
314
+ endpoint?: string;
315
+ environment?: string;
316
+ appVersion?: string;
317
+ buildId?: string;
318
+ release?: string;
319
+ debug?: boolean;
320
+ user?: UserInfoInput;
321
+ reporter?: ReporterUiConfig;
322
+ collect?: CollectConfig;
323
+ privacy?: PrivacyConfig;
324
+ filtering?: FilteringConfig;
325
+ hooks?: HooksConfig;
326
+ screenshot?: ScreenshotConfig;
327
+ transport?: TransportConfig;
328
+ upload?: UploadConfig;
329
+ }
330
+ export interface ResolvedReporterUiConfig {
331
+ enabled: boolean;
332
+ position: 'bottom-right' | 'bottom-left';
333
+ theme: 'light' | 'dark' | 'auto';
334
+ text: string;
335
+ zIndex: number;
336
+ visibility: {
337
+ mode: 'always' | 'triggered';
338
+ queryParam: string;
339
+ queryValue: string;
340
+ closable: boolean;
341
+ };
342
+ }
343
+ export interface ResolvedCollectConfig {
344
+ console: boolean;
345
+ error: boolean;
346
+ network: boolean;
347
+ networkBody: boolean;
348
+ realtime: boolean;
349
+ resourceErrors: boolean;
350
+ environment: boolean;
351
+ trackIds: boolean;
352
+ breadcrumbs: boolean;
353
+ maxBreadcrumbs: number;
354
+ maxConsoleLogs: number;
355
+ maxNetworkRecords: number;
356
+ maxErrors: number;
357
+ maxNetworkBytes: number;
358
+ maxCloneBytes: number;
359
+ requestHeaders: string[] | true;
360
+ responseHeaders: string[] | true;
361
+ maxElements: number;
362
+ eventListenerErrors: boolean;
363
+ }
364
+ export interface ResolvedPrivacyConfig {
365
+ excludeUrls: Array<string | RegExp>;
366
+ excludeConsolePatterns: Array<string | RegExp>;
367
+ excludeBreadcrumbUrls: Array<string | RegExp>;
368
+ }
369
+ export interface ResolvedScreenshotConfig {
370
+ enabled: boolean;
371
+ auto: boolean;
372
+ quality: number;
373
+ maxWidth: number;
374
+ maxSizeKB: number;
375
+ scriptUrl: string;
376
+ }
377
+ export interface ResolvedTransportConfig {
378
+ timeoutMs: number;
379
+ retries: number;
380
+ headers: Record<string, string>;
381
+ maxItemBytes: number;
382
+ totalTimeoutMs: number;
383
+ maxConcurrent: number;
384
+ logLevel?: 1 | 2 | 3;
385
+ offline: {
386
+ enabled: boolean;
387
+ ttlMs: number;
388
+ maxItems: number;
389
+ };
390
+ maxReportsPerSession: number;
391
+ }
392
+ export interface ResolvedUploadConfig {
393
+ enabled: boolean;
394
+ url: string;
395
+ bizId: string;
396
+ timeoutMs: number;
397
+ }
398
+ export interface ResolvedFilteringConfig {
399
+ ignoreErrors: Array<string | RegExp>;
400
+ denyUrls: Array<string | RegExp>;
401
+ allowUrls: Array<string | RegExp>;
402
+ }
403
+ export interface ResolvedBugTapConfig {
404
+ project: string;
405
+ endpoint: string;
406
+ environment: string;
407
+ debug: boolean;
408
+ appVersion: string;
409
+ buildId: string;
410
+ release: string;
411
+ user: UserInfoInput | undefined;
412
+ reporter: ResolvedReporterUiConfig;
413
+ collect: ResolvedCollectConfig;
414
+ privacy: ResolvedPrivacyConfig;
415
+ filtering: ResolvedFilteringConfig;
416
+ hooks: HooksConfig;
417
+ screenshot: ResolvedScreenshotConfig;
418
+ transport: ResolvedTransportConfig;
419
+ upload: ResolvedUploadConfig;
420
+ }
421
+ export interface VueErrorHandler {
422
+ (error: unknown, instance: unknown, info: string): void;
423
+ }
424
+ export interface VueAppLike {
425
+ config?: {
426
+ errorHandler?: VueErrorHandler | null;
427
+ } | null;
428
+ }
429
+ export interface ReactErrorInfo {
430
+ componentStack?: string;
431
+ }
432
+ export interface ReactErrorHandlers {
433
+ onUncaughtError(error: unknown, info: ReactErrorInfo): void;
434
+ onCaughtError(error: unknown, info: ReactErrorInfo): void;
435
+ onRecoverableError(error: unknown, info: ReactErrorInfo): void;
436
+ }
437
+ export interface BugTapApi {
438
+ open(): void;
439
+ close(): void;
440
+ openReporter(): void;
441
+ closeReporter(): void;
442
+ setConfig(patch: Partial<BugTapConfig>): void;
443
+ setUser(user: UserInfoInput | null): void;
444
+ setTag(key: string, value: string | number | boolean): void;
445
+ setExtra(key: string, value: unknown): void;
446
+ setContext(name: string, context: Record<string, unknown>): void;
447
+ addBreadcrumb(breadcrumb: Omit<Breadcrumb, 't' | 'type'> & {
448
+ type?: Breadcrumb['type'];
449
+ message?: string;
450
+ }): void;
451
+ captureException(error: unknown, context?: Record<string, unknown>): void;
452
+ captureMessage(message: string, context?: Record<string, unknown>): void;
453
+ disableRouteCapture(): void;
454
+ installVueErrorHandler(app: VueAppLike): () => void;
455
+ reactErrorHandlers(): ReactErrorHandlers;
456
+ destroy(): void;
457
+ getReport(): BugReport;
458
+ flush(): Promise<number>;
459
+ }
@@ -0,0 +1,51 @@
1
+ import type { ElementSnapshot } from '../types';
2
+ export interface PickerOptions {
3
+ ignoreElements?: Element[];
4
+ hint?: string;
5
+ }
6
+ export declare class ElementPicker {
7
+ private host;
8
+ private root;
9
+ private box;
10
+ private badge;
11
+ private confirmBar;
12
+ private confirmText;
13
+ private hovered;
14
+ private pending;
15
+ private raf;
16
+ private active;
17
+ private lastX;
18
+ private lastY;
19
+ private pointerKnown;
20
+ private resolve;
21
+ private previousCursor;
22
+ private altPressed;
23
+ private coarsePointer;
24
+ private touchStartX;
25
+ private touchStartY;
26
+ private touchMoved;
27
+ start(options?: PickerOptions): Promise<ElementSnapshot | null>;
28
+ private detectCoarsePointer;
29
+ stop(): void;
30
+ private mount;
31
+ private ignoreElements;
32
+ private isIgnored;
33
+ private hitTest;
34
+ private onMouseMove;
35
+ private onScroll;
36
+ private scheduleUpdate;
37
+ private updateHighlight;
38
+ private onClick;
39
+ private onMousePress;
40
+ private onPointerPress;
41
+ private onSuppress;
42
+ private onTouchStart;
43
+ private onTouchEnd;
44
+ private onTouchMove;
45
+ private isOwnUi;
46
+ private setPending;
47
+ private clearPending;
48
+ private onKeyDown;
49
+ private onKeyUp;
50
+ private finish;
51
+ }
@@ -0,0 +1,43 @@
1
+ export interface FloatingButtonOptions {
2
+ text: string;
3
+ position: 'bottom-right' | 'bottom-left';
4
+ onClick: () => void;
5
+ onDragEnd?: (state: FabPosition) => void;
6
+ }
7
+ export interface FabPosition {
8
+ side: 'left' | 'right';
9
+ top: number;
10
+ }
11
+ export declare class FloatingButton {
12
+ private readonly options;
13
+ readonly el: HTMLButtonElement;
14
+ private readonly wrapper;
15
+ private startX;
16
+ private startY;
17
+ private originLeft;
18
+ private originTop;
19
+ private dragging;
20
+ private moved;
21
+ private suppressClick;
22
+ private scrollTimer;
23
+ private scrolling;
24
+ private listeningScroll;
25
+ constructor(options: FloatingButtonOptions);
26
+ get element(): HTMLElement;
27
+ private bindScroll;
28
+ private unbindScroll;
29
+ private onScroll;
30
+ private bindEvents;
31
+ /** 首次打开面板时展示 loading,直到面板渲染完成 */
32
+ setLoading(loading: boolean): void;
33
+ private onPointerDown;
34
+ private onPointerMove;
35
+ private onPointerUp;
36
+ private applyPosition;
37
+ private snapTo;
38
+ /** 首次挂载时恢复上次位置,没有则用默认位置 */
39
+ restorePosition(): void;
40
+ show(): void;
41
+ hide(): void;
42
+ destroy(): void;
43
+ }
@@ -0,0 +1 @@
1
+ export declare const FAB_ICON = "\n<svg viewBox=\"0 0 24 24\" width=\"20\" height=\"20\" fill=\"none\"\n stroke=\"currentColor\" stroke-width=\"1.9\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\n aria-hidden=\"true\" focusable=\"false\">\n <path d=\"M21 11.5a8.38 8.38 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.38 8.38 0 0 1-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.38 8.38 0 0 1 3.8-.9h.5a8.48 8.48 0 0 1 8 8v.5z\"/>\n <path d=\"M12 7.6v4.6\"/>\n <circle cx=\"12\" cy=\"15.2\" r=\"1\" fill=\"currentColor\" stroke=\"none\"/>\n</svg>";
@@ -0,0 +1,20 @@
1
+ import type { ElementSnapshot, ReporterFormValues, Screenshot, SubmitResponse } from '../types';
2
+ export interface PanelCallbacks {
3
+ onSubmit(values: ReporterFormValues, screenshots: Screenshot[], elements: ElementSnapshot[]): Promise<SubmitResponse>;
4
+ onClose?(): void;
5
+ onCapture(): Promise<Screenshot>;
6
+ onUpload(file: File): Promise<Screenshot>;
7
+ onPickElement(): Promise<ElementSnapshot | null>;
8
+ onDisable?: () => void;
9
+ canUploadScreenshot?: boolean;
10
+ maxElements?: number;
11
+ }
12
+ export declare class ReporterPanel {
13
+ readonly overlay: HTMLDivElement;
14
+ private readonly app;
15
+ private readonly api;
16
+ constructor(callbacks: PanelCallbacks);
17
+ open(autoCapture?: boolean): void;
18
+ close(): void;
19
+ unmount(): void;
20
+ }
@@ -0,0 +1,15 @@
1
+ import type { PanelCallbacks } from './panel-mount';
2
+ type __VLS_Props = {
3
+ callbacks: PanelCallbacks;
4
+ };
5
+ declare function show(autoCapture?: boolean): void;
6
+ declare function hide(): void;
7
+ declare function resetView(): void;
8
+ declare function resetForm(): void;
9
+ declare const _default: import("vue").DefineComponent<__VLS_Props, {
10
+ show: typeof show;
11
+ hide: typeof hide;
12
+ resetForm: typeof resetForm;
13
+ resetView: typeof resetView;
14
+ }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
15
+ export default _default;
@@ -0,0 +1,2 @@
1
+ /** 按绝对地址注入脚本并取回全局入口;加载完成但没有暴露入口时明确报错 */
2
+ export declare function loadScreenshotGlobal(url: string): Promise<unknown>;
@@ -0,0 +1,14 @@
1
+ /**
2
+ * 截图库加载实现(ESM 产物)。
3
+ *
4
+ * 两种模式,由 `screenshot.scriptUrl` 决定:
5
+ * - 默认:`import('html2canvas-pro')`,业务打包器拆成按需 chunk
6
+ * - 配了 `scriptUrl`:改用外部脚本,适合 webpack 4 这类解析器不支持 ES2020 语法的场景
7
+ * (html2canvas-pro 的产物含 `??`,webpack 4 的 acorn 会直接解析失败)
8
+ *
9
+ * IIFE 构建会用 `screenshot-loader.iife.ts` 替换本文件(见 vite.config.ts 的 alias)。
10
+ */
11
+ import type { Html2Canvas } from './screenshot';
12
+ /** 由 SDK 在配置解析 / setConfig 时调用 */
13
+ export declare function setScreenshotScriptUrl(url: string): void;
14
+ export declare function loadHtml2CanvasImpl(): Promise<Html2Canvas>;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * 截图库加载实现(IIFE 产物)。
3
+ *
4
+ * 主包 `bug-tap.min.js` 必须保持单文件且不含 html2canvas:
5
+ * 首次需要截图时,注入 `bug-tap-screenshot.min.js`。
6
+ *
7
+ * 地址解析顺序:
8
+ * 1. `screenshot.scriptUrl` 显式配置(支持相对路径 / 绝对 URL)
9
+ * 2. 与主包同目录(读取 `<script src>` 的 URL 再替换文件名)
10
+ *
11
+ * 这个文件通过 vite.config.ts 的 alias 替换掉 `screenshot-loader.ts`。
12
+ */
13
+ import type { Html2Canvas } from './screenshot';
14
+ /** 由 SDK 在配置解析 / setConfig 时调用 */
15
+ export declare function setScreenshotScriptUrl(url: string): void;
16
+ export declare function loadHtml2CanvasImpl(): Promise<Html2Canvas>;
@@ -0,0 +1,20 @@
1
+ import type { Screenshot } from '../types';
2
+ /**
3
+ * html2canvas-pro 体积约 51KB gzip,只有用户点开面板需要截图时才会用到。
4
+ *
5
+ * 加载方式由构建产物决定(见 `screenshot-loader.ts` / `screenshot-loader.iife.ts`):
6
+ * - ESM:`import('html2canvas-pro')`,业务打包器拆成按需 chunk
7
+ * - IIFE:注入 `bug-tap-screenshot.min.js`,地址可由 `screenshot.scriptUrl` 指定
8
+ */
9
+ export type Html2Canvas = typeof import('html2canvas-pro').default;
10
+ /** 由 SDK 在配置解析 / setConfig 时调用,仅 IIFE 生效 */
11
+ export declare function configureScreenshotScript(url: string): void;
12
+ export interface CaptureOptions {
13
+ ignoreElement?: HTMLElement | null;
14
+ quality: number;
15
+ maxWidth: number;
16
+ maxSizeKB: number;
17
+ source?: 'auto' | 'manual';
18
+ }
19
+ export declare function captureViewport(options: CaptureOptions): Promise<Screenshot>;
20
+ export declare function readImageFile(file: File, options: CaptureOptions): Promise<Screenshot>;
@@ -0,0 +1,16 @@
1
+ export type ThemeMode = 'light' | 'dark' | 'auto';
2
+ export declare class ShadowHost {
3
+ private readonly theme;
4
+ readonly host: HTMLDivElement;
5
+ readonly root: ShadowRoot;
6
+ private media;
7
+ private readonly onThemeChange;
8
+ constructor(theme: ThemeMode, zIndex: number);
9
+ mount(): void;
10
+ unmount(): void;
11
+ private injectStyles;
12
+ private bindTheme;
13
+ private unbindTheme;
14
+ private applyTheme;
15
+ private resolveTheme;
16
+ }
@@ -0,0 +1 @@
1
+ export declare const STYLES = "\n:host {\n all: initial;\n --br-bg: #ffffff;\n --br-bg-soft: #f6f8fa;\n --br-fg: #1f2328;\n --br-muted: #656d76;\n --br-border: #d0d7de;\n --br-primary: #1d64e0;\n --br-primary-fg: #ffffff;\n --br-danger: #d1242f;\n --br-ok: #1a7f37;\n --br-shadow: 0 8px 30px rgba(15, 23, 42, .18);\n --br-radius: 10px;\n --br-z: 2147483000;\n position: fixed;\n inset: 0;\n z-index: var(--br-z);\n pointer-events: none;\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;\n font-size: 14px;\n line-height: 1.6;\n color: var(--br-fg);\n -webkit-font-smoothing: antialiased;\n}\n\n:host([data-theme=\"dark\"]) {\n --br-bg: #1c2128;\n --br-bg-soft: #22272e;\n --br-fg: #e6edf3;\n --br-muted: #9198a1;\n --br-border: #3d444d;\n --br-primary: #4d8ff0;\n --br-primary-fg: #0d1117;\n --br-danger: #f85149;\n --br-ok: #3fb950;\n --br-shadow: 0 8px 30px rgba(0, 0, 0, .5);\n}\n\n*, *::before, *::after { box-sizing: border-box; }\n\n.br-fab-wrap {\n position: fixed;\n right: calc(20px + env(safe-area-inset-right, 0px));\n bottom: calc(20px + env(safe-area-inset-bottom, 0px));\n z-index: calc(var(--br-z) + 1);\n display: inline-flex;\n align-items: center;\n gap: 4px;\n pointer-events: auto;\n touch-action: none;\n transition: opacity .2s ease;\n}\n.br-fab-wrap--left { right: auto; left: calc(20px + env(safe-area-inset-left, 0px)); }\n.br-fab-wrap--hidden { display: none; }\n.br-fab-wrap--free { right: auto; bottom: auto; }\n.br-fab-wrap--dragging { cursor: grabbing; transition: none; }\n/* \u6EDA\u52A8\u65F6\u6DE1\u5316\uFF0C\u51CF\u5C11\u5BF9\u5185\u5BB9\u7684\u5E72\u6270 */\n.br-fab-wrap--scrolling { opacity: .42; }\n.br-fab-wrap--scrolling .br-fab { box-shadow: 0 2px 8px rgba(15, 23, 42, .16); }\n.br-fab-wrap--dragging .br-fab { transform: scale(1.04); box-shadow: 0 10px 26px rgba(15, 23, 42, .32); }\n\n.br-fab-icon {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n width: 20px;\n height: 20px;\n transition: opacity .15s ease;\n}\n.br-fab-icon svg { display: block; }\n\n/* loading\uFF1A\u56FE\u6807\u6DE1\u51FA\uFF0C\u73AF\u5F62\u6307\u793A\u5668\u8986\u76D6\u4E0A\u6765 */\n.br-fab--loading { cursor: progress; }\n.br-fab--loading .br-fab-icon { opacity: 0; }\n.br-fab--loading::after {\n content: '';\n position: absolute;\n width: 18px;\n height: 18px;\n border: 2px solid rgba(255, 255, 255, .35);\n border-top-color: var(--br-primary-fg);\n border-radius: 50%;\n animation: br-spin .7s linear infinite;\n}\n@keyframes br-spin { to { transform: rotate(360deg); } }\n@media (prefers-reduced-motion: reduce) {\n .br-fab--loading::after { animation-duration: 2s; }\n}\n\n.br-fab {\n position: relative;\n display: inline-flex;\n align-items: center;\n justify-content: center;\n width: 46px;\n height: 46px;\n padding: 0;\n border: 1px solid rgba(255, 255, 255, .18);\n border-radius: 50%;\n background: var(--br-primary);\n color: var(--br-primary-fg);\n box-shadow: var(--br-shadow);\n cursor: grab;\n pointer-events: auto;\n user-select: none;\n touch-action: none;\n transition: transform .15s ease, opacity .15s ease, box-shadow .15s ease;\n}\n.br-fab:hover { transform: translateY(-1px); }\n.br-fab:active { cursor: grabbing; }\n.br-fab:focus-visible { outline: 2px solid #fff; outline-offset: 2px; }\n\n.br-overlay {\n position: fixed;\n inset: 0;\n z-index: calc(var(--br-z) + 2);\n display: none;\n background: rgba(15, 23, 42, .38);\n pointer-events: auto;\n}\n.br-overlay--open { display: block; }\n.br-overlay--hidden { display: none; }\n.br-panel--hidden { display: none !important; }\n\n.br-panel {\n position: fixed;\n top: 50%;\n left: 50%;\n transform: translate(-50%, -50%);\n width: 640px;\n max-width: calc(100vw - 40px);\n height: 80vh;\n max-height: 900px;\n display: none;\n flex-direction: column;\n background: var(--br-bg);\n color: var(--br-fg);\n border-radius: 16px;\n box-shadow: var(--br-shadow);\n pointer-events: auto;\n overflow: hidden;\n}\n.br-panel--open { display: flex; }\n\n.br-header {\n display: flex;\n align-items: center;\n gap: 10px;\n padding: 14px 16px;\n border-bottom: 1px solid var(--br-border);\n background: var(--br-bg);\n}\n.br-heading { flex: 1; margin: 0; font-size: 15px; font-weight: 600; }\n.br-close {\n width: 30px;\n height: 30px;\n border: 1px solid var(--br-border);\n border-radius: 8px;\n background: transparent;\n color: var(--br-muted);\n font: inherit;\n font-size: 16px;\n line-height: 1;\n cursor: pointer;\n}\n.br-close:hover { background: var(--br-bg-soft); color: var(--br-fg); }\n\n.br-body {\n flex: 1;\n overflow-y: auto;\n padding: 14px 16px 18px;\n display: flex;\n flex-direction: column;\n gap: 14px;\n}\n\n.br-hidden { display: none !important; }\n.br-form { display: flex; flex-direction: column; gap: 14px; }\n.br-field { display: flex; flex-direction: column; gap: 6px; }\n.br-label { font-size: 13px; font-weight: 600; color: var(--br-fg); }\n.br-required { color: var(--br-danger); margin-left: 2px; }\n.br-hint { font-size: 12px; color: var(--br-muted); }\n\n.br-input, .br-textarea, .br-select {\n width: 100%;\n border: 1px solid var(--br-border);\n border-radius: 8px;\n background: var(--br-bg);\n color: var(--br-fg);\n font: inherit;\n font-size: 13px;\n padding: 8px 10px;\n outline: none;\n}\n.br-input:focus, .br-textarea:focus, .br-select:focus {\n border-color: var(--br-primary);\n box-shadow: 0 0 0 3px rgba(29, 100, 224, .16);\n}\n.br-textarea { resize: vertical; min-height: 96px; }\n.br-row { display: flex; gap: 10px; }\n.br-row > .br-field { flex: 1; min-width: 0; }\n\n.br-shot-preview {\n display: block;\n width: 100%;\n max-height: 220px;\n margin-top: 8px;\n object-fit: contain;\n object-position: top center;\n border: 1px dashed var(--br-border);\n border-radius: 8px;\n background: var(--br-bg-soft);\n}\n.br-shot-actions { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }\n.br-shot-status { font-size: 12px; color: var(--br-muted); }\n.br-btn--link-inline {\n padding: 0;\n border: 0;\n background: transparent;\n color: var(--br-primary);\n font: inherit;\n font-size: 12px;\n cursor: pointer;\n}\n.br-btn--link-inline:hover { text-decoration: underline; }\n.br-element-box { display: flex; flex-direction: column; gap: 8px; }\n.br-element-list { display: flex; flex-direction: column; gap: 4px; }\n.br-element-item {\n display: flex;\n align-items: center;\n gap: 8px;\n padding: 4px 6px 4px 8px;\n border: 1px solid var(--br-border);\n border-radius: 6px;\n background: var(--br-bg-soft);\n}\n.br-element-item-text {\n flex: 1;\n min-width: 0;\n overflow: hidden;\n text-overflow: ellipsis;\n white-space: nowrap;\n font-family: ui-monospace, SFMono-Regular, Menlo, monospace;\n font-size: 12px;\n color: var(--br-fg);\n}\n.br-element-item-del {\n flex: none;\n width: 18px;\n height: 18px;\n padding: 0;\n border: 0;\n border-radius: 4px;\n background: transparent;\n color: var(--br-muted);\n font: inherit;\n font-size: 14px;\n line-height: 1;\n cursor: pointer;\n}\n.br-element-item-del:hover { background: var(--br-border); color: var(--br-fg); }\n\n.br-thumb-list { display: flex; flex-wrap: wrap; gap: 8px; }\n.br-attach-row { display: flex; align-items: center; gap: 8px; }\n.br-thumb {\n position: relative;\n width: 72px;\n height: 72px;\n border: 1px solid var(--br-border);\n border-radius: 6px;\n overflow: hidden;\n background: var(--br-bg-soft);\n}\n.br-thumb img { width: 100%; height: 100%; object-fit: cover; display: block; }\n/* \u81EA\u52A8\u622A\u56FE\u89D2\u6807\uFF1A\u4E0E\u7528\u6237\u624B\u52A8\u4E0A\u4F20\u7684\u56FE\u533A\u5206\u5F00\uFF0C\u907F\u514D\u8BEF\u4EE5\u4E3A\u662F\u81EA\u5DF1\u7684\u56FE */\n.br-thumb-tag {\n position: absolute;\n left: 2px;\n bottom: 2px;\n padding: 1px 5px;\n border-radius: 4px;\n background: rgba(15, 23, 42, .62);\n color: #fff;\n font: 11px/1.4 -apple-system, \"Segoe UI\", \"Microsoft YaHei\", sans-serif;\n pointer-events: none;\n}\n.br-thumb-del {\n position: absolute;\n top: 2px;\n right: 2px;\n width: 18px;\n height: 18px;\n padding: 0;\n border: 0;\n border-radius: 50%;\n background: rgba(15, 23, 42, .62);\n color: #fff;\n font: inherit;\n font-size: 13px;\n line-height: 1;\n cursor: pointer;\n opacity: 0;\n transition: opacity .15s ease;\n}\n.br-thumb:hover .br-thumb-del,\n.br-thumb-del:focus-visible { opacity: 1; }\n@media (max-width: 560px) {\n .br-thumb-del { opacity: 1; }\n}\n\n.br-footer {\n display: flex;\n align-items: center;\n gap: 10px;\n padding: 12px 16px;\n border-top: 1px solid var(--br-border);\n background: var(--br-bg);\n}\n.br-footer .br-spacer { flex: 1; }\n\n.br-btn {\n border: 1px solid var(--br-border);\n border-radius: 8px;\n background: var(--br-bg);\n color: var(--br-fg);\n font: inherit;\n font-size: 13px;\n padding: 7px 14px;\n cursor: pointer;\n}\n.br-btn:hover { background: var(--br-bg-soft); }\n.br-btn:disabled { opacity: .55; cursor: not-allowed; }\n.br-btn--primary {\n border-color: var(--br-primary);\n background: var(--br-primary);\n color: var(--br-primary-fg);\n}\n.br-btn--primary:hover { filter: brightness(1.05); background: var(--br-primary); }\n.br-btn--ghost { background: transparent; }\n.br-btn--link {\n padding: 0;\n border: 0;\n background: transparent;\n color: var(--br-muted);\n font-size: 12px;\n text-decoration: underline;\n cursor: pointer;\n margin-right: auto;\n}\n.br-btn--link:hover { color: var(--br-fg); }\n.br-btn--sm { padding: 4px 10px; font-size: 12px; }\n\n.br-status { font-size: 12px; color: var(--br-muted); min-height: 18px; }\n.br-status--error { color: var(--br-danger); }\n.br-status--ok { color: var(--br-ok); }\n\n.br-success { display: flex; flex-direction: column; gap: 12px; padding: 8px 0; }\n.br-success-title { font-size: 15px; font-weight: 600; color: var(--br-ok); }\n.br-link { color: var(--br-primary); text-decoration: underline; word-break: break-all; }\n.br-success-actions { display: flex; gap: 8px; margin-top: 4px; }\n\n@media (max-width: 560px) {\n .br-panel {\n top: auto;\n left: 0;\n right: 0;\n bottom: 0;\n transform: none;\n width: auto;\n max-width: none;\n height: 75vh;\n max-height: 85vh;\n border-radius: 16px 16px 0 0;\n padding-bottom: env(safe-area-inset-bottom, 0px);\n }\n .br-row { flex-direction: column; gap: 14px; }\n .br-fab-wrap { right: calc(14px + env(safe-area-inset-right, 0px)); bottom: calc(14px + env(safe-area-inset-bottom, 0px)); }\n .br-fab-wrap--left { right: auto; left: calc(14px + env(safe-area-inset-left, 0px)); }\n}\n";