context-drop 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/MIT-LICENSE +21 -0
- package/README.md +709 -2
- package/app/assets/javascripts/context_drop/context_drop.js +8936 -0
- package/dist/app/javascript/context_drop/api-client.d.ts +41 -0
- package/dist/app/javascript/context_drop/api-client.js +279 -0
- package/dist/app/javascript/context_drop/element-picker.d.ts +111 -0
- package/dist/app/javascript/context_drop/element-picker.js +1428 -0
- package/dist/app/javascript/context_drop/icons.d.ts +32 -0
- package/dist/app/javascript/context_drop/icons.js +32 -0
- package/dist/app/javascript/context_drop/index.d.ts +7 -0
- package/dist/app/javascript/context_drop/index.js +9 -0
- package/dist/app/javascript/context_drop/markdown.d.ts +7 -0
- package/dist/app/javascript/context_drop/markdown.js +129 -0
- package/dist/app/javascript/context_drop/sanitizer.d.ts +38 -0
- package/dist/app/javascript/context_drop/sanitizer.js +769 -0
- package/dist/app/javascript/context_drop/screenshot.d.ts +21 -0
- package/dist/app/javascript/context_drop/screenshot.js +245 -0
- package/dist/app/javascript/context_drop/styles.d.ts +1 -0
- package/dist/app/javascript/context_drop/styles.js +2015 -0
- package/dist/app/javascript/context_drop/types.d.ts +239 -0
- package/dist/app/javascript/context_drop/types.js +1 -0
- package/dist/app/javascript/context_drop/widget.d.ts +188 -0
- package/dist/app/javascript/context_drop/widget.js +3227 -0
- package/dist/src/cli.d.ts +3 -0
- package/dist/src/cli.js +207 -0
- package/dist/src/index.d.ts +5 -0
- package/dist/src/index.js +5 -0
- package/dist/src/mcp/dispatcher.d.ts +42 -0
- package/dist/src/mcp/dispatcher.js +869 -0
- package/dist/src/mcp/environment-router.d.ts +38 -0
- package/dist/src/mcp/environment-router.js +174 -0
- package/dist/src/mcp/index.d.ts +24 -0
- package/dist/src/mcp/index.js +75 -0
- package/dist/src/mcp/remote-client.d.ts +25 -0
- package/dist/src/mcp/remote-client.js +98 -0
- package/dist/src/next/index.d.ts +13 -0
- package/dist/src/next/index.js +25 -0
- package/dist/src/next/server.d.ts +1 -0
- package/dist/src/next/server.js +1 -0
- package/dist/src/react/index.d.ts +90 -0
- package/dist/src/react/index.js +124 -0
- package/dist/src/server/handler.d.ts +42 -0
- package/dist/src/server/handler.js +677 -0
- package/dist/src/server/index.d.ts +8 -0
- package/dist/src/server/index.js +8 -0
- package/dist/src/server/sanitizer.d.ts +15 -0
- package/dist/src/server/sanitizer.js +201 -0
- package/dist/src/server/storage/local.d.ts +22 -0
- package/dist/src/server/storage/local.js +574 -0
- package/dist/src/server/storage/memory.d.ts +5 -0
- package/dist/src/server/storage/memory.js +221 -0
- package/dist/src/server/storage/postgres.d.ts +27 -0
- package/dist/src/server/storage/postgres.js +446 -0
- package/dist/src/server/types.d.ts +190 -0
- package/dist/src/server/types.js +7 -0
- package/dist/src/server/upload-validator.d.ts +16 -0
- package/dist/src/server/upload-validator.js +196 -0
- package/dist/src/widget/index.d.ts +1 -0
- package/dist/src/widget/index.js +1 -0
- package/package.json +99 -4
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { AgentChatRequestPayload, AgentChatResponse, AgentKeysUpdatePayload, AgentKeysUpdateResponse, AgentStatusResponse, ContextDropApiClientOptions, CrossEnvFeedbackListResponse, FeedbackSubmissionPayload, FeedbackSubmissionResponse, ProposedFileEdit, WidgetConfig } from "./types.js";
|
|
2
|
+
export declare class ContextDropApiClient {
|
|
3
|
+
private baseUrl;
|
|
4
|
+
private credentials;
|
|
5
|
+
private customHeaders;
|
|
6
|
+
private cachedCsrfToken;
|
|
7
|
+
private configFetched;
|
|
8
|
+
private inFlightConfigPromise;
|
|
9
|
+
constructor(baseUrl?: string, options?: ContextDropApiClientOptions);
|
|
10
|
+
getBaseUrl(): string;
|
|
11
|
+
setCredentials(credentials: RequestCredentials): void;
|
|
12
|
+
setHeaders(headers: Record<string, string>): void;
|
|
13
|
+
private isCrossOriginEndpoint;
|
|
14
|
+
private mergeClientHeaders;
|
|
15
|
+
getCsrfToken(): string | null;
|
|
16
|
+
setCsrfToken(token: string | null): void;
|
|
17
|
+
private getMetaCsrfToken;
|
|
18
|
+
fetchConfig(): Promise<WidgetConfig>;
|
|
19
|
+
resolveCsrfToken(forceRefresh?: boolean): Promise<string | null>;
|
|
20
|
+
private isCsrfError;
|
|
21
|
+
private executeWithCsrfRetry;
|
|
22
|
+
private buildJsonHeaders;
|
|
23
|
+
uploadAttachment(file: Blob, filename: string): Promise<{
|
|
24
|
+
signed_blob_id: string;
|
|
25
|
+
}>;
|
|
26
|
+
submitFeedback(payload: FeedbackSubmissionPayload): Promise<FeedbackSubmissionResponse>;
|
|
27
|
+
fetchAgentStatus(): Promise<AgentStatusResponse>;
|
|
28
|
+
saveAgentKeys(payload: AgentKeysUpdatePayload): Promise<AgentKeysUpdateResponse>;
|
|
29
|
+
deleteAgentKeys(provider?: string): Promise<AgentKeysUpdateResponse>;
|
|
30
|
+
fetchAgentFeedbacks(environment?: string, status?: string): Promise<CrossEnvFeedbackListResponse>;
|
|
31
|
+
sendAgentChat(payload: AgentChatRequestPayload): Promise<AgentChatResponse>;
|
|
32
|
+
applyEdit(editId: string): Promise<{
|
|
33
|
+
edit: ProposedFileEdit;
|
|
34
|
+
}>;
|
|
35
|
+
rejectEdit(editId: string): Promise<{
|
|
36
|
+
edit: ProposedFileEdit;
|
|
37
|
+
}>;
|
|
38
|
+
revertEdit(editId: string): Promise<{
|
|
39
|
+
edit: ProposedFileEdit;
|
|
40
|
+
}>;
|
|
41
|
+
}
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
export class ContextDropApiClient {
|
|
2
|
+
baseUrl;
|
|
3
|
+
credentials;
|
|
4
|
+
customHeaders;
|
|
5
|
+
cachedCsrfToken = null;
|
|
6
|
+
configFetched = false;
|
|
7
|
+
inFlightConfigPromise = null;
|
|
8
|
+
constructor(baseUrl = "/context_drop", options = {}) {
|
|
9
|
+
this.baseUrl = baseUrl.replace(/\/+$/, "") || "/context_drop";
|
|
10
|
+
this.credentials = options.credentials || "same-origin";
|
|
11
|
+
this.customHeaders = options.headers ? { ...options.headers } : {};
|
|
12
|
+
}
|
|
13
|
+
getBaseUrl() {
|
|
14
|
+
return this.baseUrl;
|
|
15
|
+
}
|
|
16
|
+
setCredentials(credentials) {
|
|
17
|
+
this.credentials = credentials;
|
|
18
|
+
}
|
|
19
|
+
setHeaders(headers) {
|
|
20
|
+
this.customHeaders = { ...headers };
|
|
21
|
+
}
|
|
22
|
+
isCrossOriginEndpoint() {
|
|
23
|
+
if (!/^https?:\/\//i.test(this.baseUrl)) {
|
|
24
|
+
return false;
|
|
25
|
+
}
|
|
26
|
+
if (typeof window === "undefined" || !window.location || !window.location.origin) {
|
|
27
|
+
return true;
|
|
28
|
+
}
|
|
29
|
+
try {
|
|
30
|
+
return new URL(this.baseUrl, window.location.origin).origin !== window.location.origin;
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
return false;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
mergeClientHeaders(base) {
|
|
37
|
+
const merged = {
|
|
38
|
+
...this.customHeaders,
|
|
39
|
+
...base
|
|
40
|
+
};
|
|
41
|
+
if (this.isCrossOriginEndpoint()) {
|
|
42
|
+
merged["X-Context-Drop-Client"] = "1";
|
|
43
|
+
}
|
|
44
|
+
return merged;
|
|
45
|
+
}
|
|
46
|
+
getCsrfToken() {
|
|
47
|
+
const metaToken = this.getMetaCsrfToken();
|
|
48
|
+
if (metaToken) {
|
|
49
|
+
return metaToken;
|
|
50
|
+
}
|
|
51
|
+
return this.cachedCsrfToken;
|
|
52
|
+
}
|
|
53
|
+
setCsrfToken(token) {
|
|
54
|
+
this.cachedCsrfToken = token ? token.trim() : null;
|
|
55
|
+
}
|
|
56
|
+
getMetaCsrfToken() {
|
|
57
|
+
if (typeof document === "undefined")
|
|
58
|
+
return null;
|
|
59
|
+
const meta = document.querySelector('meta[name="csrf-token"]');
|
|
60
|
+
const content = meta ? meta.getAttribute("content") : null;
|
|
61
|
+
return content && content.trim().length > 0 ? content.trim() : null;
|
|
62
|
+
}
|
|
63
|
+
async fetchConfig() {
|
|
64
|
+
if (this.inFlightConfigPromise) {
|
|
65
|
+
return this.inFlightConfigPromise;
|
|
66
|
+
}
|
|
67
|
+
this.inFlightConfigPromise = (async () => {
|
|
68
|
+
try {
|
|
69
|
+
const response = await fetch(`${this.baseUrl}/config`, {
|
|
70
|
+
method: "GET",
|
|
71
|
+
credentials: this.credentials,
|
|
72
|
+
headers: this.mergeClientHeaders({
|
|
73
|
+
Accept: "application/json"
|
|
74
|
+
})
|
|
75
|
+
});
|
|
76
|
+
if (!response.ok) {
|
|
77
|
+
throw new Error(`Failed to fetch ContextDrop config (${response.status})`);
|
|
78
|
+
}
|
|
79
|
+
const config = (await response.json());
|
|
80
|
+
this.configFetched = true;
|
|
81
|
+
if (config && typeof config.csrf_token === "string" && config.csrf_token.trim().length > 0) {
|
|
82
|
+
this.cachedCsrfToken = config.csrf_token.trim();
|
|
83
|
+
if (typeof document !== "undefined") {
|
|
84
|
+
const meta = document.querySelector('meta[name="csrf-token"]');
|
|
85
|
+
if (meta) {
|
|
86
|
+
meta.setAttribute("content", this.cachedCsrfToken);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return config;
|
|
91
|
+
}
|
|
92
|
+
finally {
|
|
93
|
+
this.inFlightConfigPromise = null;
|
|
94
|
+
}
|
|
95
|
+
})();
|
|
96
|
+
return this.inFlightConfigPromise;
|
|
97
|
+
}
|
|
98
|
+
async resolveCsrfToken(forceRefresh = false) {
|
|
99
|
+
if (!forceRefresh) {
|
|
100
|
+
const metaToken = this.getMetaCsrfToken();
|
|
101
|
+
if (metaToken) {
|
|
102
|
+
return metaToken;
|
|
103
|
+
}
|
|
104
|
+
if (this.cachedCsrfToken) {
|
|
105
|
+
return this.cachedCsrfToken;
|
|
106
|
+
}
|
|
107
|
+
if (this.configFetched) {
|
|
108
|
+
return null;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
try {
|
|
112
|
+
const config = await this.fetchConfig();
|
|
113
|
+
if (config && config.csrf_token) {
|
|
114
|
+
return config.csrf_token.trim();
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
catch {
|
|
118
|
+
// Continue and fall back to current token or null
|
|
119
|
+
}
|
|
120
|
+
return this.cachedCsrfToken || this.getMetaCsrfToken();
|
|
121
|
+
}
|
|
122
|
+
isCsrfError(status, message) {
|
|
123
|
+
if (status !== 422)
|
|
124
|
+
return false;
|
|
125
|
+
return /csrf|authenticity/i.test(message);
|
|
126
|
+
}
|
|
127
|
+
async executeWithCsrfRetry(requestFn, defaultErrorMessage) {
|
|
128
|
+
let csrfToken = await this.resolveCsrfToken(false);
|
|
129
|
+
let response = await requestFn(csrfToken);
|
|
130
|
+
if (response.ok) {
|
|
131
|
+
return (await response.json());
|
|
132
|
+
}
|
|
133
|
+
if (response.status === 422) {
|
|
134
|
+
const rawText = await response.text();
|
|
135
|
+
let parsedError = null;
|
|
136
|
+
try {
|
|
137
|
+
const json = JSON.parse(rawText);
|
|
138
|
+
if (json && typeof json.error === "string") {
|
|
139
|
+
parsedError = json.error;
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
catch {
|
|
143
|
+
// Not JSON
|
|
144
|
+
}
|
|
145
|
+
const errorMessage = parsedError || rawText || "";
|
|
146
|
+
const shouldRetryCsrf = this.isCsrfError(response.status, errorMessage) ||
|
|
147
|
+
(!csrfToken && !this.configFetched && response.status === 422);
|
|
148
|
+
if (shouldRetryCsrf) {
|
|
149
|
+
csrfToken = await this.resolveCsrfToken(true);
|
|
150
|
+
response = await requestFn(csrfToken);
|
|
151
|
+
if (response.ok) {
|
|
152
|
+
return (await response.json());
|
|
153
|
+
}
|
|
154
|
+
const retryErrBody = await response.json().catch(() => ({}));
|
|
155
|
+
throw new Error(retryErrBody.error || `${defaultErrorMessage} (${response.status})`);
|
|
156
|
+
}
|
|
157
|
+
throw new Error(parsedError || errorMessage || `${defaultErrorMessage} (${response.status})`);
|
|
158
|
+
}
|
|
159
|
+
const errBody = await response.json().catch(() => ({}));
|
|
160
|
+
throw new Error(errBody.error || `${defaultErrorMessage} (${response.status})`);
|
|
161
|
+
}
|
|
162
|
+
buildJsonHeaders(csrfToken) {
|
|
163
|
+
const headers = {
|
|
164
|
+
"Content-Type": "application/json",
|
|
165
|
+
Accept: "application/json"
|
|
166
|
+
};
|
|
167
|
+
if (csrfToken) {
|
|
168
|
+
headers["X-CSRF-Token"] = csrfToken;
|
|
169
|
+
}
|
|
170
|
+
return this.mergeClientHeaders(headers);
|
|
171
|
+
}
|
|
172
|
+
async uploadAttachment(file, filename) {
|
|
173
|
+
const makeRequest = async (csrfToken) => {
|
|
174
|
+
const formData = new FormData();
|
|
175
|
+
formData.append("file", file, filename);
|
|
176
|
+
const headers = {
|
|
177
|
+
Accept: "application/json"
|
|
178
|
+
};
|
|
179
|
+
if (csrfToken) {
|
|
180
|
+
headers["X-CSRF-Token"] = csrfToken;
|
|
181
|
+
}
|
|
182
|
+
return fetch(`${this.baseUrl}/attachments`, {
|
|
183
|
+
method: "POST",
|
|
184
|
+
credentials: this.credentials,
|
|
185
|
+
headers: this.mergeClientHeaders(headers),
|
|
186
|
+
body: formData
|
|
187
|
+
});
|
|
188
|
+
};
|
|
189
|
+
return this.executeWithCsrfRetry(makeRequest, "Upload failed");
|
|
190
|
+
}
|
|
191
|
+
async submitFeedback(payload) {
|
|
192
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/feedback`, {
|
|
193
|
+
method: "POST",
|
|
194
|
+
credentials: this.credentials,
|
|
195
|
+
headers: this.buildJsonHeaders(csrfToken),
|
|
196
|
+
body: JSON.stringify({ feedback: payload })
|
|
197
|
+
});
|
|
198
|
+
return this.executeWithCsrfRetry(makeRequest, "Submission failed");
|
|
199
|
+
}
|
|
200
|
+
async fetchAgentStatus() {
|
|
201
|
+
const response = await fetch(`${this.baseUrl}/agent/status`, {
|
|
202
|
+
method: "GET",
|
|
203
|
+
credentials: this.credentials,
|
|
204
|
+
headers: this.mergeClientHeaders({
|
|
205
|
+
Accept: "application/json"
|
|
206
|
+
})
|
|
207
|
+
});
|
|
208
|
+
if (!response.ok) {
|
|
209
|
+
const errBody = await response.json().catch(() => ({}));
|
|
210
|
+
throw new Error(errBody.error || `Failed to load agent status (${response.status})`);
|
|
211
|
+
}
|
|
212
|
+
return (await response.json());
|
|
213
|
+
}
|
|
214
|
+
async saveAgentKeys(payload) {
|
|
215
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/agent/keys`, {
|
|
216
|
+
method: "POST",
|
|
217
|
+
credentials: this.credentials,
|
|
218
|
+
headers: this.buildJsonHeaders(csrfToken),
|
|
219
|
+
body: JSON.stringify(payload)
|
|
220
|
+
});
|
|
221
|
+
return this.executeWithCsrfRetry(makeRequest, "Failed to save BYOK settings");
|
|
222
|
+
}
|
|
223
|
+
async deleteAgentKeys(provider = "all") {
|
|
224
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/agent/keys?provider=${encodeURIComponent(provider)}`, {
|
|
225
|
+
method: "DELETE",
|
|
226
|
+
credentials: this.credentials,
|
|
227
|
+
headers: this.buildJsonHeaders(csrfToken)
|
|
228
|
+
});
|
|
229
|
+
return this.executeWithCsrfRetry(makeRequest, "Failed to clear BYOK key");
|
|
230
|
+
}
|
|
231
|
+
async fetchAgentFeedbacks(environment = "all", status = "new") {
|
|
232
|
+
const qs = `environment=${encodeURIComponent(environment)}&status=${encodeURIComponent(status)}`;
|
|
233
|
+
const response = await fetch(`${this.baseUrl}/agent/feedbacks?${qs}`, {
|
|
234
|
+
method: "GET",
|
|
235
|
+
credentials: this.credentials,
|
|
236
|
+
headers: this.mergeClientHeaders({
|
|
237
|
+
Accept: "application/json"
|
|
238
|
+
})
|
|
239
|
+
});
|
|
240
|
+
if (!response.ok) {
|
|
241
|
+
const errBody = await response.json().catch(() => ({}));
|
|
242
|
+
throw new Error(errBody.error || `Failed to load feedbacks (${response.status})`);
|
|
243
|
+
}
|
|
244
|
+
return (await response.json());
|
|
245
|
+
}
|
|
246
|
+
async sendAgentChat(payload) {
|
|
247
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/agent/chat`, {
|
|
248
|
+
method: "POST",
|
|
249
|
+
credentials: this.credentials,
|
|
250
|
+
headers: this.buildJsonHeaders(csrfToken),
|
|
251
|
+
body: JSON.stringify(payload)
|
|
252
|
+
});
|
|
253
|
+
return this.executeWithCsrfRetry(makeRequest, "Agent request failed");
|
|
254
|
+
}
|
|
255
|
+
async applyEdit(editId) {
|
|
256
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/agent/edits/${encodeURIComponent(editId)}/apply`, {
|
|
257
|
+
method: "POST",
|
|
258
|
+
credentials: this.credentials,
|
|
259
|
+
headers: this.buildJsonHeaders(csrfToken)
|
|
260
|
+
});
|
|
261
|
+
return this.executeWithCsrfRetry(makeRequest, "Failed to apply file edit");
|
|
262
|
+
}
|
|
263
|
+
async rejectEdit(editId) {
|
|
264
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/agent/edits/${encodeURIComponent(editId)}/reject`, {
|
|
265
|
+
method: "POST",
|
|
266
|
+
credentials: this.credentials,
|
|
267
|
+
headers: this.buildJsonHeaders(csrfToken)
|
|
268
|
+
});
|
|
269
|
+
return this.executeWithCsrfRetry(makeRequest, "Failed to reject file edit");
|
|
270
|
+
}
|
|
271
|
+
async revertEdit(editId) {
|
|
272
|
+
const makeRequest = async (csrfToken) => fetch(`${this.baseUrl}/agent/edits/${encodeURIComponent(editId)}/revert`, {
|
|
273
|
+
method: "POST",
|
|
274
|
+
credentials: this.credentials,
|
|
275
|
+
headers: this.buildJsonHeaders(csrfToken)
|
|
276
|
+
});
|
|
277
|
+
return this.executeWithCsrfRetry(makeRequest, "Failed to revert file edit");
|
|
278
|
+
}
|
|
279
|
+
}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import type { ElementCandidateInfo, ElementReferenceSnapshot, SelectionMode } from "./types.js";
|
|
2
|
+
export interface PinnedElementEntry {
|
|
3
|
+
clientRef: string;
|
|
4
|
+
selector: string;
|
|
5
|
+
friendlyLabel?: string;
|
|
6
|
+
element: Element;
|
|
7
|
+
}
|
|
8
|
+
export interface ElementPickerStateSnapshot {
|
|
9
|
+
active: boolean;
|
|
10
|
+
anchored: boolean;
|
|
11
|
+
scrubbing: boolean;
|
|
12
|
+
activeCandidate: ElementCandidateInfo | null;
|
|
13
|
+
candidateStack: ElementCandidateInfo[];
|
|
14
|
+
ancestors: Element[];
|
|
15
|
+
lastAction?: {
|
|
16
|
+
kind: "pinned" | "unpinned";
|
|
17
|
+
selector: string;
|
|
18
|
+
} | null;
|
|
19
|
+
}
|
|
20
|
+
export interface ElementPickerCallbacks {
|
|
21
|
+
onSelect: (snapshot: ElementReferenceSnapshot, element: Element) => void;
|
|
22
|
+
onUnselect?: (clientRef: string, element: Element) => void;
|
|
23
|
+
onExit: () => void;
|
|
24
|
+
canSelectMore: () => boolean;
|
|
25
|
+
getExcludedSelectors: () => string[];
|
|
26
|
+
getSelectionMode?: () => SelectionMode;
|
|
27
|
+
getPinnedElements?: () => PinnedElementEntry[];
|
|
28
|
+
onStateChange?: (state: ElementPickerStateSnapshot) => void;
|
|
29
|
+
}
|
|
30
|
+
export declare class ElementPicker {
|
|
31
|
+
private active;
|
|
32
|
+
private suppressCursorPin;
|
|
33
|
+
private isScrubbingLayers;
|
|
34
|
+
private scrubOriginX;
|
|
35
|
+
private scrubOriginY;
|
|
36
|
+
private lastPointerX;
|
|
37
|
+
private lastPointerY;
|
|
38
|
+
private wheelAccumulator;
|
|
39
|
+
private lastWheelStepAt;
|
|
40
|
+
private callbacks;
|
|
41
|
+
private overlayEl;
|
|
42
|
+
private leafOutlineEl;
|
|
43
|
+
private hudEl;
|
|
44
|
+
private pinMarkerEl;
|
|
45
|
+
private pinnedMarkersContainerEl;
|
|
46
|
+
private toastEl;
|
|
47
|
+
private previewOverlayEl;
|
|
48
|
+
private pulseTimer;
|
|
49
|
+
private nudgeTimer;
|
|
50
|
+
private toastTimer;
|
|
51
|
+
private candidateStack;
|
|
52
|
+
private activeCandidateIndex;
|
|
53
|
+
private leafElement;
|
|
54
|
+
private lastAction;
|
|
55
|
+
private previousCursor;
|
|
56
|
+
private boundMouseMove;
|
|
57
|
+
private boundClickCapture;
|
|
58
|
+
private boundPointerCapture;
|
|
59
|
+
private boundBlurSuppression;
|
|
60
|
+
private boundWheelCapture;
|
|
61
|
+
private boundKeyDown;
|
|
62
|
+
private boundScrollOrResize;
|
|
63
|
+
constructor(callbacks: ElementPickerCallbacks);
|
|
64
|
+
isActive(): boolean;
|
|
65
|
+
isAnchored(): boolean;
|
|
66
|
+
isScrubbing(): boolean;
|
|
67
|
+
private isSmartMode;
|
|
68
|
+
getActiveCandidate(): ElementCandidateInfo | null;
|
|
69
|
+
getCandidateStack(): ElementCandidateInfo[];
|
|
70
|
+
start(options?: {
|
|
71
|
+
suppressCursorPin?: boolean;
|
|
72
|
+
}): void;
|
|
73
|
+
stop(options?: {
|
|
74
|
+
silent?: boolean;
|
|
75
|
+
}): void;
|
|
76
|
+
highlightAtPoint(x: number, y: number, event?: Event): void;
|
|
77
|
+
clearCandidateHighlight(): void;
|
|
78
|
+
commitActiveCandidate(x?: number, y?: number): boolean;
|
|
79
|
+
focusCandidateElement(el: Element): void;
|
|
80
|
+
selectElementDirectly(el: Element): boolean;
|
|
81
|
+
refreshPinnedMarkers(): void;
|
|
82
|
+
showExternalPreview(el: Element | null): void;
|
|
83
|
+
hideExternalPreview(): void;
|
|
84
|
+
cycleDepth(delta: number, revealStack?: boolean): void;
|
|
85
|
+
private clearTimers;
|
|
86
|
+
private findPinnedIndex;
|
|
87
|
+
private notifyStateChange;
|
|
88
|
+
private mountSelectionUi;
|
|
89
|
+
private unmountSelectionUi;
|
|
90
|
+
private isInternalUiEvent;
|
|
91
|
+
private collectPointElements;
|
|
92
|
+
private updateCandidatesFromPoint;
|
|
93
|
+
private handleViewportScrollOrResize;
|
|
94
|
+
private handleMouseMove;
|
|
95
|
+
private createSpanEl;
|
|
96
|
+
private createKbdEl;
|
|
97
|
+
private renderSmartHudContent;
|
|
98
|
+
private renderCompactHudContent;
|
|
99
|
+
private renderScrubbingHudContent;
|
|
100
|
+
private positionHudElement;
|
|
101
|
+
private updateOverlayPosition;
|
|
102
|
+
private triggerHudBoundaryNudge;
|
|
103
|
+
private flashSelectionPulse;
|
|
104
|
+
private showCursorToast;
|
|
105
|
+
private commitCandidateSelection;
|
|
106
|
+
private handleWheelCapture;
|
|
107
|
+
private handlePointerSuppression;
|
|
108
|
+
private handleBlurSuppression;
|
|
109
|
+
private handleClickCapture;
|
|
110
|
+
private handleKeyDown;
|
|
111
|
+
}
|