@vinena/knobs 0.5.0 → 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 (75) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +7 -0
  3. package/dist/early.global.js +6 -6
  4. package/dist/{elementsview-6g274ptr.js → elementsview-2z4pkrdz.js} +4 -4
  5. package/dist/{elementsview-pkzp9kc6.js → elementsview-qn8qyksa.js} +4 -4
  6. package/dist/engine/browserdraw.d.ts +24 -2
  7. package/dist/engine/browserkit.d.ts +18 -1
  8. package/dist/engine/browserui.d.ts +162 -22
  9. package/dist/engine/devicon.d.ts +59 -0
  10. package/dist/engine/fit.d.ts +4 -3
  11. package/dist/engine/foldflip.d.ts +40 -0
  12. package/dist/engine/identity.d.ts +7 -4
  13. package/dist/engine/mock.d.ts +16 -0
  14. package/dist/engine/mockdata.d.ts +4 -1
  15. package/dist/engine/mockdraw.d.ts +14 -2
  16. package/dist/engine/pageshot.d.ts +5 -2
  17. package/dist/engine/safaridraw.d.ts +162 -10
  18. package/dist/engine/screen.d.ts +24 -0
  19. package/dist/engine/store.d.ts +2 -1
  20. package/dist/engine/tabicon.d.ts +43 -0
  21. package/dist/engine/toplayer.d.ts +62 -0
  22. package/dist/engine/touchpointer.d.ts +0 -21
  23. package/dist/engine/underbar.d.ts +61 -0
  24. package/dist/{framekit-g96t6nmq.js → framekit-te90cjs0.js} +2325 -1572
  25. package/dist/{framekit-3n7p79ht.js → framekit-w0v516w5.js} +2325 -1572
  26. package/dist/host.d.ts +51 -0
  27. package/dist/{index-64rd634h.js → index-30fc6php.js} +1 -1
  28. package/dist/{index-dvr4x91q.js → index-9re7sv56.js} +20 -8
  29. package/dist/{index-0casarhy.js → index-agwr37gw.js} +1 -1
  30. package/dist/{index-2d6wvs8h.js → index-dan2kpsd.js} +4 -4
  31. package/dist/{index-kzsb9drs.js → index-hv02xka3.js} +20 -8
  32. package/dist/{index-peh33xjv.js → index-pewcdh28.js} +1 -1
  33. package/dist/{index-d0cjxjsm.js → index-r72tz2vn.js} +1 -1
  34. package/dist/{index-33x9hxe3.js → index-sxe5079a.js} +605 -187
  35. package/dist/{index-5d6qzte3.js → index-trx7bxdk.js} +4 -4
  36. package/dist/{index-5baxvd3v.js → index-xjhwp5cj.js} +275 -112
  37. package/dist/index.d.ts +26 -1
  38. package/dist/index.global.js +270 -176
  39. package/dist/index.js +398 -124
  40. package/dist/instance.d.ts +23 -4
  41. package/dist/{react-pdvseef0.js → react-05jh9jv5.js} +1 -1
  42. package/dist/{react-4kbj1t4h.js → react-16spgn0h.js} +1 -1
  43. package/dist/{react-65tgdbs8.js → react-4pvp6amm.js} +1 -1
  44. package/dist/{react-qv0nykcv.js → react-ayg1bgw3.js} +602 -184
  45. package/dist/{react-xxfpfddf.js → react-exjcpxma.js} +1 -1
  46. package/dist/{react-carf84xv.js → react-fm9y8dbn.js} +275 -112
  47. package/dist/{react-mv9y20jy.js → react-sw8d8c94.js} +4 -4
  48. package/dist/{react-71a9ypex.js → react-zy1mmhgz.js} +4 -4
  49. package/dist/react.js +394 -123
  50. package/dist/{storageview-vdkbp6rt.js → storageview-r595qpt9.js} +4 -4
  51. package/dist/{storageview-j9d44f99.js → storageview-s7heg93p.js} +4 -4
  52. package/dist/types.d.ts +7 -0
  53. package/dist/ui/footer.d.ts +9 -2
  54. package/dist/ui/panel.d.ts +16 -2
  55. package/dist/ui/settings.d.ts +17 -1
  56. package/dist/version.d.ts +2 -0
  57. package/package.json +3 -2
  58. package/skills/devknobs/SKILL.md +1 -1
  59. package/dist/elementsview-jnkbhzkj.js +0 -2873
  60. package/dist/elementsview-tf4qzmtw.js +0 -2874
  61. package/dist/engine/endroom.d.ts +0 -21
  62. package/dist/framekit-095qevka.js +0 -8838
  63. package/dist/framekit-q5aad770.js +0 -8839
  64. package/dist/index-hw56t3zy.js +0 -4800
  65. package/dist/index-k015tb6c.js +0 -357
  66. package/dist/index-ke6v7919.js +0 -4801
  67. package/dist/index-qxye1j73.js +0 -528
  68. package/dist/index-z5ytnj01.js +0 -4563
  69. package/dist/index-zvze25nf.js +0 -686
  70. package/dist/react-eygws6cx.js +0 -358
  71. package/dist/react-sq9pkw4k.js +0 -687
  72. package/dist/react-vjm88w4t.js +0 -4564
  73. package/dist/react-znfrjqk8.js +0 -529
  74. package/dist/storageview-sb23henh.js +0 -2729
  75. package/dist/storageview-vf8v8q8j.js +0 -2728
@@ -1,529 +0,0 @@
1
- "use client";
2
- import {
3
- label
4
- } from "./react-adky72h9.js";
5
- import {
6
- frameWindow,
7
- isFunctionKey,
8
- keyIs,
9
- subscribe,
10
- typesInField,
11
- withShift
12
- } from "./react-vjm88w4t.js";
13
- import {
14
- __require,
15
- addStyle,
16
- isDevknobsFrame,
17
- needsFrame,
18
- post,
19
- readMessage,
20
- systemMedia
21
- } from "./react-carf84xv.js";
22
-
23
- // src/grab/keys.ts
24
- var HOLD = 100;
25
- var HOLD_INPUT = 400;
26
- var HOLD_SELECTION = 600;
27
- var HOLD_AFTER_COPY = 200;
28
- var C_LIKE = new Set([
29
- "c",
30
- "C",
31
- "с",
32
- "С",
33
- "ȼ",
34
- "Ȼ",
35
- "ↄ",
36
- "Ↄ",
37
- "ᴄ",
38
- "ᶜ",
39
- "ⱼ",
40
- "ⅽ",
41
- "Ⅽ",
42
- "ç",
43
- "Ç",
44
- "ć",
45
- "Ć",
46
- "č",
47
- "Č",
48
- "ĉ",
49
- "Ĉ",
50
- "ċ",
51
- "Ċ"
52
- ]);
53
- function isCLike(key, code) {
54
- if (code === "KeyC")
55
- return true;
56
- return key.length === 1 && C_LIKE.has(key);
57
- }
58
- function defaultGrabKey() {
59
- return withShift("g");
60
- }
61
- function keyMatches(event, key) {
62
- return key === "c" ? isCLike(event.key, event.code) : keyIs(event, key);
63
- }
64
- function pressTurnsOn(key) {
65
- return isFunctionKey(key.key) || !key.meta && !key.ctrl && !key.alt;
66
- }
67
- function grabKeyTypes(key) {
68
- return !isFunctionKey(key.key) && !key.meta && !key.ctrl && !key.alt;
69
- }
70
- function isGrabKey(event, key) {
71
- return event.isComposing !== true && event.metaKey === key.meta && event.ctrlKey === key.ctrl && event.shiftKey === key.shift && event.altKey === key.alt && keyMatches(event, key.key);
72
- }
73
- function releasesGrabKey(event, key) {
74
- if (keyMatches(event, key.key))
75
- return true;
76
- return key.meta && event.key === "Meta" || key.ctrl && event.key === "Control" || key.shift && event.key === "Shift" || key.alt && event.key === "Alt";
77
- }
78
- function holdDuration(scene, base = HOLD) {
79
- if (scene.selection)
80
- return base + HOLD_SELECTION;
81
- return scene.input ? base + HOLD_INPUT : base;
82
- }
83
- function holdStep(hold, event) {
84
- if (event.type === "down") {
85
- return {
86
- hold: hold ?? { start: event.at, duration: event.duration, copied: false, due: false },
87
- activate: false
88
- };
89
- }
90
- if (!hold)
91
- return { hold: null, activate: false };
92
- switch (event.type) {
93
- case "copy":
94
- return { hold: { ...hold, copied: true }, activate: false };
95
- case "timer":
96
- return hold.copied ? { hold: { ...hold, due: true }, activate: false } : done(true);
97
- case "repeat":
98
- return hold.due ? done(true) : { hold, activate: false };
99
- case "release":
100
- return done(hold.due && event.at - hold.start >= HOLD_AFTER_COPY);
101
- case "cancel":
102
- return done(false);
103
- }
104
- }
105
- function done(activate) {
106
- return { hold: null, activate };
107
- }
108
-
109
- // src/grab/place.ts
110
- function grabStep(place, event) {
111
- switch (event.type) {
112
- case "ask":
113
- if (!event.on)
114
- return "off";
115
- return event.frame ? "frame" : "here";
116
- case "frame":
117
- return event.on ? "frame" : "off";
118
- case "framed":
119
- if (place === "here" && event.frame)
120
- return "off";
121
- if (place === "frame" && !event.frame)
122
- return "off";
123
- return place;
124
- }
125
- }
126
-
127
- // src/grab/control.ts
128
- var MODIFIER_KEYS = new Set(["Meta", "Control", "Shift", "Alt", "AltGraph", "CapsLock"]);
129
- function deepActive() {
130
- let active = document.activeElement;
131
- while (active?.shadowRoot?.activeElement)
132
- active = active.shadowRoot.activeElement;
133
- return active;
134
- }
135
- function holdScene() {
136
- const active = deepActive();
137
- const field = active instanceof HTMLInputElement || active instanceof HTMLTextAreaElement;
138
- const input = field || active instanceof HTMLElement && active.isContentEditable;
139
- let selection = (window.getSelection()?.toString() ?? "") !== "";
140
- if (field) {
141
- try {
142
- selection ||= active.selectionStart !== active.selectionEnd;
143
- } catch {}
144
- }
145
- return { input, selection };
146
- }
147
- function systemScheme() {
148
- const own = systemMedia();
149
- if (own)
150
- return own.scheme;
151
- const host = document.createElement("div");
152
- host.setAttribute("data-devknobs", "probe");
153
- host.style.cssText = "position:fixed;width:0;height:0;overflow:hidden;pointer-events:none";
154
- const root = host.attachShadow({ mode: "open" });
155
- addStyle(root, "i{display:block;width:0}@media (prefers-color-scheme: dark){i{width:1px}}");
156
- const probe = document.createElement("i");
157
- root.append(probe);
158
- (document.body ?? document.documentElement).append(host);
159
- const dark = probe.getBoundingClientRect().width > 0;
160
- host.remove();
161
- return dark ? "dark" : "light";
162
- }
163
- function createGrab(options = {}, loadMode = () => import("./index-kzsb9drs.js")) {
164
- const keyNow = options.key ?? defaultGrabKey;
165
- const { purpose } = options;
166
- const channel = purpose?.channel ?? "grab";
167
- const inFrame = isDevknobsFrame();
168
- const listeners = new Set;
169
- let place = "off";
170
- let mode = null;
171
- let turn = 0;
172
- let hold = null;
173
- let holdTimer = 0;
174
- let pointer = null;
175
- let scheme;
176
- function frame() {
177
- return inFrame ? null : frameWindow();
178
- }
179
- function startLocal() {
180
- const at = ++turn;
181
- loadMode().then(({ startMode }) => {
182
- if (at !== turn || place !== "here")
183
- return;
184
- mode = startMode({
185
- pointer,
186
- scheme,
187
- purpose,
188
- heldKey: (event) => {
189
- const key = keyNow();
190
- return key !== null && keyMatches(event, key.key);
191
- },
192
- onExit: () => {
193
- mode = null;
194
- move("off");
195
- }
196
- });
197
- });
198
- }
199
- function stopLocal() {
200
- turn++;
201
- mode?.stop();
202
- mode = null;
203
- }
204
- function move(to) {
205
- if (to === place)
206
- return;
207
- const was = place !== "off";
208
- if (place === "here")
209
- stopLocal();
210
- place = to;
211
- if (to === "here")
212
- startLocal();
213
- const on = to !== "off";
214
- if (on === was)
215
- return;
216
- if (inFrame)
217
- post(window.parent, { source: "devknobs", type: channel, on });
218
- for (const listener of Array.from(listeners))
219
- listener(on);
220
- }
221
- function set(next) {
222
- const target = frame();
223
- const to = grabStep(place, { type: "ask", on: next, frame: target !== null });
224
- if (target && (to === "frame" || place === "frame")) {
225
- post(target, { source: "devknobs", type: channel, on: next, scheme: systemScheme() });
226
- if (next)
227
- target.focus();
228
- }
229
- move(to);
230
- }
231
- function step(event) {
232
- const result = holdStep(hold, event);
233
- hold = result.hold;
234
- if (!hold)
235
- clearTimeout(holdTimer);
236
- if (result.activate)
237
- set(true);
238
- }
239
- function onKeydown(event) {
240
- const key = keyNow();
241
- const press = key !== null && pressTurnsOn(key);
242
- const grabKey = key !== null && isGrabKey(event, key) && !(grabKeyTypes(key) && typesInField(event));
243
- if (grabKey && press) {
244
- event.preventDefault();
245
- if (!event.repeat)
246
- set(place === "off");
247
- return;
248
- }
249
- if (mode) {
250
- mode.keydown(event);
251
- return;
252
- }
253
- if (place !== "off") {
254
- if (event.key === "Escape") {
255
- event.preventDefault();
256
- event.stopImmediatePropagation();
257
- set(false);
258
- }
259
- return;
260
- }
261
- if (grabKey) {
262
- if (event.repeat) {
263
- step({ type: "repeat" });
264
- return;
265
- }
266
- if (hold)
267
- return;
268
- const duration = holdDuration(holdScene());
269
- step({ type: "down", at: Date.now(), duration });
270
- clearTimeout(holdTimer);
271
- holdTimer = window.setTimeout(() => step({ type: "timer" }), duration);
272
- return;
273
- }
274
- if (hold && !MODIFIER_KEYS.has(event.key))
275
- step({ type: "cancel" });
276
- }
277
- function onKeyup(event) {
278
- const key = keyNow();
279
- if (hold && key && releasesGrabKey(event, key))
280
- step({ type: "release", at: Date.now() });
281
- }
282
- function onCopy() {
283
- if (hold)
284
- step({ type: "copy" });
285
- }
286
- function onBlur() {
287
- if (hold)
288
- step({ type: "cancel" });
289
- }
290
- function onPointer(event) {
291
- pointer = { x: event.clientX, y: event.clientY };
292
- }
293
- function onMessage(event) {
294
- if (inFrame) {
295
- const message2 = readMessage(event, window.parent, window.location.origin);
296
- if (message2?.type !== channel)
297
- return;
298
- scheme = message2.scheme;
299
- set(message2.on);
300
- return;
301
- }
302
- const message = readMessage(event, frameWindow(), window.location.origin);
303
- if (message?.type === channel)
304
- move(grabStep(place, { type: "frame", on: message.on }));
305
- else if (message?.type === "ready")
306
- move(grabStep(place, { type: "frame", on: false }));
307
- }
308
- const unsubscribe = subscribe((state) => {
309
- if (!inFrame)
310
- move(grabStep(place, { type: "framed", frame: needsFrame(state) }));
311
- });
312
- window.addEventListener("keydown", onKeydown, true);
313
- window.addEventListener("keyup", onKeyup, true);
314
- window.addEventListener("blur", onBlur);
315
- window.addEventListener("pointermove", onPointer, { capture: true, passive: true });
316
- window.addEventListener("message", onMessage);
317
- document.addEventListener("copy", onCopy, true);
318
- return {
319
- isOn: () => place !== "off",
320
- set,
321
- subscribe(listener) {
322
- listeners.add(listener);
323
- return () => {
324
- listeners.delete(listener);
325
- };
326
- },
327
- destroy() {
328
- set(false);
329
- stopLocal();
330
- unsubscribe();
331
- clearTimeout(holdTimer);
332
- listeners.clear();
333
- window.removeEventListener("keydown", onKeydown, true);
334
- window.removeEventListener("keyup", onKeyup, true);
335
- window.removeEventListener("blur", onBlur);
336
- window.removeEventListener("pointermove", onPointer, true);
337
- window.removeEventListener("message", onMessage);
338
- document.removeEventListener("copy", onCopy, true);
339
- }
340
- };
341
- }
342
-
343
- // src/grab/inspect.ts
344
- function oneAtATime(grab, inspect) {
345
- const stops = [
346
- grab.subscribe((on) => {
347
- if (on)
348
- inspect.set(false);
349
- }),
350
- inspect.subscribe((on) => {
351
- if (on)
352
- grab.set(false);
353
- })
354
- ];
355
- return () => {
356
- for (const stop of stops)
357
- stop();
358
- };
359
- }
360
- var HELD = Symbol.for("devknobs.inspected");
361
- function isElement(value) {
362
- return typeof value === "object" && value !== null && "nodeType" in value && value.nodeType === 1;
363
- }
364
- function held(view) {
365
- try {
366
- const value = Reflect.get(view, HELD);
367
- return isElement(value) ? value : null;
368
- } catch {
369
- return null;
370
- }
371
- }
372
- function createInspect(options = {}, load = () => import("./index-kzsb9drs.js"), frameOf = frameWindow) {
373
- const inFrame = isDevknobsFrame();
374
- const listeners = new Set;
375
- let outliner = null;
376
- let boxed = null;
377
- let tinted = null;
378
- let destroyed = false;
379
- function pick(element) {
380
- if (inFrame) {
381
- Reflect.set(window, HELD, element);
382
- post(window.parent, { source: "devknobs", type: "picked" });
383
- return;
384
- }
385
- for (const listener of Array.from(listeners))
386
- listener(element);
387
- }
388
- const control = createGrab({
389
- key: options.key,
390
- purpose: {
391
- channel: "inspect",
392
- label: (element) => ({ tag: "styles", name: label(element) }),
393
- pick
394
- }
395
- }, load);
396
- function box(element) {
397
- boxed = element;
398
- if (outliner) {
399
- outliner.show(element);
400
- return;
401
- }
402
- if (!element)
403
- return;
404
- load().then(({ createOutline }) => {
405
- if (destroyed)
406
- return;
407
- outliner ??= createOutline();
408
- outliner.show(boxed);
409
- if (tinted)
410
- outliner.area(tinted);
411
- });
412
- }
413
- function outline(element) {
414
- const view = inFrame ? null : frameOf();
415
- if (view) {
416
- try {
417
- const theirs = element !== null && element.ownerDocument === view.document;
418
- Reflect.set(view, HELD, theirs ? element : null);
419
- post(view, { source: "devknobs", type: "outline" });
420
- } catch {}
421
- }
422
- box(element?.ownerDocument === document ? element : null);
423
- }
424
- function area(ring) {
425
- const view = inFrame ? null : frameOf();
426
- if (view)
427
- post(view, { source: "devknobs", type: "area", ring });
428
- tint(ring);
429
- }
430
- function tint(ring) {
431
- tinted = ring;
432
- outliner?.area(ring);
433
- }
434
- function onMessage(event) {
435
- if (inFrame) {
436
- const message2 = readMessage(event, window.parent, window.location.origin);
437
- if (message2?.type === "outline")
438
- box(held(window));
439
- else if (message2?.type === "area")
440
- tint(message2.ring);
441
- return;
442
- }
443
- const view = frameOf();
444
- const message = readMessage(event, view, window.location.origin);
445
- const element = message?.type === "picked" && view ? held(view) : null;
446
- if (element)
447
- pick(element);
448
- }
449
- window.addEventListener("message", onMessage);
450
- return {
451
- ...control,
452
- onPick(listener) {
453
- listeners.add(listener);
454
- return () => {
455
- listeners.delete(listener);
456
- };
457
- },
458
- outline,
459
- area,
460
- destroy() {
461
- destroyed = true;
462
- control.destroy();
463
- window.removeEventListener("message", onMessage);
464
- listeners.clear();
465
- outliner?.destroy();
466
- outliner = null;
467
- }
468
- };
469
- }
470
-
471
- // src/grab/copy.ts
472
- async function copyText(text, data = { "text/plain": text }) {
473
- const onCopy = (event) => {
474
- event.preventDefault();
475
- for (const [type, value] of Object.entries(data))
476
- event.clipboardData?.setData(type, value);
477
- };
478
- const textarea = document.createElement("textarea");
479
- textarea.value = text;
480
- textarea.setAttribute("data-devknobs", "grab");
481
- textarea.setAttribute("aria-hidden", "true");
482
- textarea.style.cssText = "position:fixed;left:-9999px;top:0;opacity:0";
483
- document.addEventListener("copy", onCopy);
484
- let copied = false;
485
- try {
486
- document.body.append(textarea);
487
- textarea.select();
488
- copied = typeof document.execCommand === "function" && document.execCommand("copy");
489
- } catch {
490
- copied = false;
491
- } finally {
492
- document.removeEventListener("copy", onCopy);
493
- textarea.remove();
494
- }
495
- if (copied)
496
- return true;
497
- try {
498
- await navigator.clipboard.writeText(text);
499
- return true;
500
- } catch {
501
- return false;
502
- }
503
- }
504
-
505
- // src/grab/colors.ts
506
- var GRAB_COLORS = {
507
- blue: { srgb: "rgb(41, 151, 255)", p3: "color(display-p3 0.2 0.6 1)" },
508
- green: { srgb: "rgb(48, 209, 88)", p3: "color(display-p3 0.25 0.85 0.4)" },
509
- pink: { srgb: "rgb(210, 57, 192)", p3: "color(display-p3 0.84 0.19 0.78)" },
510
- orange: { srgb: "rgb(255, 149, 0)", p3: "color(display-p3 1 0.58 0)" },
511
- purple: { srgb: "rgb(175, 82, 222)", p3: "color(display-p3 0.69 0.3 0.9)" },
512
- cyan: { srgb: "rgb(50, 200, 230)", p3: "color(display-p3 0.2 0.8 0.92)" }
513
- };
514
- var GRAB_COLOR_NAMES = Object.keys(GRAB_COLORS);
515
- function grabColor(value, tone) {
516
- return value === "auto" ? tone : value;
517
- }
518
- var BOX_HUES = {
519
- margin: "rgb(246, 178, 107)",
520
- border: "rgb(255, 221, 128)",
521
- padding: "rgb(147, 196, 125)",
522
- content: "rgb(111, 168, 220)"
523
- };
524
- var BOX_TINT = 50;
525
- function boxTint(ring, percent = BOX_TINT, ground = "transparent") {
526
- return `color-mix(in srgb, ${BOX_HUES[ring]} ${percent}%, ${ground})`;
527
- }
528
-
529
- export { GRAB_COLORS, GRAB_COLOR_NAMES, grabColor, boxTint, isCLike, copyText, oneAtATime, isElement, createInspect, createGrab };