@glasshome/ui 1.10.0 → 1.11.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.
Files changed (113) hide show
  1. package/SPEC.md +7 -0
  2. package/dist/index.js +1 -1
  3. package/dist/lib/menu-classes.d.ts +2 -2
  4. package/dist/solid/icon.d.ts +18 -12
  5. package/dist/solid/index.d.ts +1 -0
  6. package/dist/solid/index.js +3692 -3490
  7. package/dist/{utils-CIwpbaOd.js → utils-CdUh67Y9.js} +1 -1
  8. package/package.json +7 -3
  9. package/scripts/check-pack.ts +32 -0
  10. package/src/index.ts +111 -0
  11. package/src/lib/menu-classes.ts +1 -1
  12. package/src/solid/accordion.tsx +60 -0
  13. package/src/solid/alert-dialog.tsx +148 -0
  14. package/src/solid/alert.tsx +118 -0
  15. package/src/solid/area-picker.tsx +225 -0
  16. package/src/solid/aspect-ratio.tsx +21 -0
  17. package/src/solid/avatar.tsx +41 -0
  18. package/src/solid/badge.tsx +74 -0
  19. package/src/solid/bottom-sheet/arbitration.ts +40 -0
  20. package/src/solid/bottom-sheet/bottom-sheet.tsx +457 -0
  21. package/src/solid/bottom-sheet/constants.ts +8 -0
  22. package/src/solid/bottom-sheet/drag-controller.ts +221 -0
  23. package/src/solid/bottom-sheet/focus-trap.ts +56 -0
  24. package/src/solid/bottom-sheet/index.ts +14 -0
  25. package/src/solid/bottom-sheet/keyboard.ts +35 -0
  26. package/src/solid/bottom-sheet/scroll-lock.ts +64 -0
  27. package/src/solid/bottom-sheet/state-machine.ts +40 -0
  28. package/src/solid/bottom-sheet/velocity.ts +42 -0
  29. package/src/solid/breadcrumb.tsx +105 -0
  30. package/src/solid/button-group.tsx +66 -0
  31. package/src/solid/button.tsx +20 -0
  32. package/src/solid/card.tsx +101 -0
  33. package/src/solid/carousel.tsx +302 -0
  34. package/src/solid/charts.tsx +338 -0
  35. package/src/solid/checkbox.tsx +70 -0
  36. package/src/solid/collapsible.tsx +38 -0
  37. package/src/solid/color-slider.tsx +98 -0
  38. package/src/solid/color-wheel.tsx +77 -0
  39. package/src/solid/context-menu.tsx +109 -0
  40. package/src/solid/copy-button.tsx +46 -0
  41. package/src/solid/count-pill.tsx +24 -0
  42. package/src/solid/data-table.tsx +248 -0
  43. package/src/solid/dialog-parts.tsx +242 -0
  44. package/src/solid/dialog.tsx +121 -0
  45. package/src/solid/dock.tsx +186 -0
  46. package/src/solid/dropdown-menu.tsx +130 -0
  47. package/src/solid/empty.tsx +99 -0
  48. package/src/solid/entity-data.ts +78 -0
  49. package/src/solid/entity-selector.tsx +697 -0
  50. package/src/solid/field.tsx +253 -0
  51. package/src/solid/form.tsx +231 -0
  52. package/src/solid/hero-action.tsx +117 -0
  53. package/src/solid/hover-card.tsx +26 -0
  54. package/src/solid/icon-picker.tsx +432 -0
  55. package/src/solid/icon.tsx +126 -0
  56. package/src/solid/image-picker.tsx +380 -0
  57. package/src/solid/index.ts +413 -0
  58. package/src/solid/input-group.tsx +170 -0
  59. package/src/solid/input-otp.tsx +175 -0
  60. package/src/solid/input.tsx +12 -0
  61. package/src/solid/item.tsx +179 -0
  62. package/src/solid/kbd.tsx +30 -0
  63. package/src/solid/label.tsx +19 -0
  64. package/src/solid/list-reorder.ts +148 -0
  65. package/src/solid/logo.tsx +79 -0
  66. package/src/solid/media-copy.ts +37 -0
  67. package/src/solid/media-store.ts +110 -0
  68. package/src/solid/media-tile.tsx +100 -0
  69. package/src/solid/menu-parts.tsx +248 -0
  70. package/src/solid/number-field.tsx +72 -0
  71. package/src/solid/option-card.tsx +218 -0
  72. package/src/solid/ornament.tsx +53 -0
  73. package/src/solid/overlay.tsx +16 -0
  74. package/src/solid/page-header.tsx +102 -0
  75. package/src/solid/pagination.tsx +111 -0
  76. package/src/solid/password-input.tsx +69 -0
  77. package/src/solid/picker-row.tsx +102 -0
  78. package/src/solid/picker-search.tsx +78 -0
  79. package/src/solid/popover.tsx +103 -0
  80. package/src/solid/progress.tsx +31 -0
  81. package/src/solid/radio-group.tsx +60 -0
  82. package/src/solid/resizable.tsx +149 -0
  83. package/src/solid/responsive-dialog.tsx +180 -0
  84. package/src/solid/schema-form.tsx +830 -0
  85. package/src/solid/scope-indicator.tsx +13 -0
  86. package/src/solid/scroll-area.tsx +27 -0
  87. package/src/solid/section-card.tsx +358 -0
  88. package/src/solid/select.tsx +139 -0
  89. package/src/solid/separator.tsx +35 -0
  90. package/src/solid/settings-row.tsx +159 -0
  91. package/src/solid/sheet.tsx +157 -0
  92. package/src/solid/skeleton.tsx +15 -0
  93. package/src/solid/slider.tsx +148 -0
  94. package/src/solid/sliding-indicator.tsx +294 -0
  95. package/src/solid/sonner.tsx +217 -0
  96. package/src/solid/spinner.tsx +20 -0
  97. package/src/solid/step-indicator.tsx +30 -0
  98. package/src/solid/switch.tsx +62 -0
  99. package/src/solid/table.tsx +98 -0
  100. package/src/solid/tabs.tsx +86 -0
  101. package/src/solid/textarea.tsx +16 -0
  102. package/src/solid/toggle-group.tsx +102 -0
  103. package/src/solid/toggle.tsx +57 -0
  104. package/src/solid/tooltip.tsx +38 -0
  105. package/src/solid/widget-card.tsx +117 -0
  106. package/src/solid/widget-identity.tsx +135 -0
  107. package/src/solid/widget-trust-badge.tsx +37 -0
  108. package/src/styles/globals.css +7 -0
  109. package/src/styles/theme.css +8 -0
  110. package/src/tokens/hex.ts +50 -0
  111. package/src/tokens/index.ts +8 -0
  112. package/src/tokens/presets.ts +192 -0
  113. package/src/tokens/theme-colors.ts +147 -0
@@ -0,0 +1,457 @@
1
+ import {
2
+ type Component,
3
+ type ComponentProps,
4
+ createContext,
5
+ createEffect,
6
+ createMemo,
7
+ createRenderEffect,
8
+ createSignal,
9
+ type JSX,
10
+ onCleanup,
11
+ type ParentComponent,
12
+ Show,
13
+ splitProps,
14
+ useContext,
15
+ type ValidComponent,
16
+ } from "solid-js";
17
+ import { Dynamic, Portal } from "solid-js/web";
18
+ import { Z } from "../../lib/layers.js";
19
+ import { OVERLAY_SURFACE_OPAQUE } from "../../lib/overlay-classes.js";
20
+ import { cn } from "../../lib/utils.js";
21
+ import {
22
+ callEventHandler,
23
+ createModalLabels,
24
+ createModalParts,
25
+ MODAL_DESCRIPTION,
26
+ MODAL_MAX_H,
27
+ MODAL_TITLE,
28
+ ModalLabelsProvider,
29
+ useModalLabels,
30
+ } from "../dialog-parts.js";
31
+ import { EASE, TRANSITION_MS } from "./constants.js";
32
+ import { attachDrag } from "./drag-controller.js";
33
+ import { type InitialFocus, trapFocus } from "./focus-trap.js";
34
+ import { watchKeyboard } from "./keyboard.js";
35
+ import { acquireScrollLock, releaseScrollLock } from "./scroll-lock.js";
36
+ import { assertTransition, type SheetState } from "./state-machine.js";
37
+
38
+ interface BottomSheetContextValue {
39
+ state: () => SheetState;
40
+ setState: (next: SheetState) => void;
41
+ open: () => boolean;
42
+ setOpen: (next: boolean) => void;
43
+ dismissible: () => boolean;
44
+ contentRef: () => HTMLDivElement | undefined;
45
+ setContentRef: (el: HTMLDivElement | undefined) => void;
46
+ }
47
+
48
+ const BottomSheetContext = createContext<BottomSheetContextValue>();
49
+
50
+ function useBottomSheetContext(): BottomSheetContextValue {
51
+ const ctx = useContext(BottomSheetContext);
52
+ if (!ctx) throw new Error("BottomSheet components must be used within <BottomSheet>");
53
+ return ctx;
54
+ }
55
+
56
+ interface BottomSheetRootProps {
57
+ open?: boolean;
58
+ defaultOpen?: boolean;
59
+ onOpenChange?: (open: boolean) => void;
60
+ dismissible?: boolean;
61
+ children: JSX.Element;
62
+ }
63
+
64
+ const BottomSheet: ParentComponent<BottomSheetRootProps> = (props) => {
65
+ const [uncontrolled, setUncontrolled] = createSignal(props.defaultOpen ?? false);
66
+ const [state, setStateRaw] = createSignal<SheetState>("closed");
67
+ const [contentRef, setContentRef] = createSignal<HTMLDivElement | undefined>(undefined);
68
+
69
+ const isControlled = () => props.open !== undefined;
70
+ const open = (): boolean => (isControlled() ? props.open === true : uncontrolled());
71
+
72
+ const setOpen = (next: boolean) => {
73
+ if (!isControlled()) setUncontrolled(next);
74
+ props.onOpenChange?.(next);
75
+ };
76
+
77
+ const setState = (next: SheetState) => {
78
+ const current = state();
79
+ assertTransition(current, next);
80
+ setStateRaw(next);
81
+ };
82
+
83
+ const dismissible = () => props.dismissible !== false;
84
+
85
+ createEffect(() => {
86
+ const isOpen = open();
87
+ const s = state();
88
+ if (isOpen && s === "closed") {
89
+ setState("opening");
90
+ } else if (
91
+ !isOpen &&
92
+ (s === "open" || s === "opening" || s === "pressing" || s === "dragging" || s === "snapping")
93
+ ) {
94
+ setState("closing");
95
+ }
96
+ });
97
+
98
+ return (
99
+ <BottomSheetContext.Provider
100
+ value={{
101
+ state,
102
+ setState,
103
+ open,
104
+ setOpen,
105
+ dismissible,
106
+ contentRef,
107
+ setContentRef,
108
+ }}
109
+ >
110
+ {props.children}
111
+ </BottomSheetContext.Provider>
112
+ );
113
+ };
114
+
115
+ /* A button by default; rendered as a link it takes the anchor's own props. */
116
+ type SheetButtonProps = ComponentProps<"button"> &
117
+ Partial<Pick<ComponentProps<"a">, "href" | "target" | "rel">> & { as?: ValidComponent };
118
+
119
+ const BottomSheetTrigger: ParentComponent<SheetButtonProps> = (props) => {
120
+ const [local, rest] = splitProps(props, ["children", "onClick", "as"]);
121
+ const ctx = useBottomSheetContext();
122
+ const component = () => local.as ?? "button";
123
+ return (
124
+ <Dynamic
125
+ component={component()}
126
+ type={component() === "button" ? "button" : undefined}
127
+ data-slot="bottom-sheet-trigger"
128
+ aria-haspopup="dialog"
129
+ aria-expanded={ctx.open()}
130
+ onClick={(event: MouseEvent & { currentTarget: HTMLButtonElement; target: Element }) => {
131
+ callEventHandler(event, local.onClick);
132
+ ctx.setOpen(true);
133
+ }}
134
+ {...rest}
135
+ >
136
+ {local.children}
137
+ </Dynamic>
138
+ );
139
+ };
140
+
141
+ interface BottomSheetPortalProps {
142
+ children: JSX.Element;
143
+ mount?: Node;
144
+ }
145
+
146
+ const BottomSheetPortal: Component<BottomSheetPortalProps> = (props) => {
147
+ const ctx = useBottomSheetContext();
148
+ const mounted = () => ctx.state() !== "closed";
149
+ return (
150
+ <Show when={mounted()}>
151
+ <Portal mount={props.mount}>{props.children}</Portal>
152
+ </Show>
153
+ );
154
+ };
155
+
156
+ const BottomSheetOverlay: Component<ComponentProps<"div">> = (props) => {
157
+ const [local, rest] = splitProps(props, ["class"]);
158
+ const ctx = useBottomSheetContext();
159
+
160
+ const dataState = () => {
161
+ const s = ctx.state();
162
+ if (s === "closing") return "closing";
163
+ if (s === "opening" || s === "closed") return s;
164
+ return "open";
165
+ };
166
+
167
+ return (
168
+ <div
169
+ data-slot="bottom-sheet-overlay"
170
+ data-sheet-overlay=""
171
+ data-state={dataState()}
172
+ aria-hidden="true"
173
+ class={cn(
174
+ "fixed inset-0 bg-black/80 transition-opacity duration-300 ease-out",
175
+ "data-[state=closing]:opacity-0 data-[state=open]:opacity-100",
176
+ local.class,
177
+ )}
178
+ style={{ "z-index": Z.sheet }}
179
+ {...rest}
180
+ />
181
+ );
182
+ };
183
+
184
+ interface BottomSheetContentProps extends ComponentProps<"div"> {
185
+ initialFocus?: InitialFocus;
186
+ /** Names a sheet that has no `BottomSheetTitle`. A registered Title wins. */
187
+ ariaLabel?: string;
188
+ }
189
+
190
+ const BottomSheetContent: ParentComponent<BottomSheetContentProps> = (props) => {
191
+ const [local, rest] = splitProps(props, ["class", "children", "initialFocus", "ariaLabel"]);
192
+ const ctx = useBottomSheetContext();
193
+ const labels = createModalLabels();
194
+ let el: HTMLDivElement | undefined;
195
+
196
+ /* Keyed on presence, not on mount: a sheet rendered without
197
+ * BottomSheetPortal stays in the tree while closed and must not hold the
198
+ * page lock. Release also runs on unmount, so no animation can strand it. */
199
+ const present = createMemo(() => ctx.state() !== "closed");
200
+ createEffect(() => {
201
+ if (!present()) return;
202
+ acquireScrollLock();
203
+ onCleanup(releaseScrollLock);
204
+ });
205
+
206
+ const clearAnimInline = () => {
207
+ if (!el) return;
208
+ el.style.transition = "";
209
+ el.style.animation = "";
210
+ el.style.transform = "";
211
+ };
212
+
213
+ const onAnimationEnd = (e: AnimationEvent) => {
214
+ if (e.target !== el) return;
215
+ const s = ctx.state();
216
+ if (s === "opening" && e.animationName === "bs-slide-up") ctx.setState("open");
217
+ else if (s === "closing" && e.animationName === "bs-slide-down") ctx.setState("closed");
218
+ };
219
+
220
+ const onTransitionEnd = (e: TransitionEvent) => {
221
+ if (e.target !== el) return;
222
+ if (e.propertyName !== "transform") return;
223
+ const s = ctx.state();
224
+ if (s === "snapping") {
225
+ ctx.setState("open");
226
+ clearAnimInline();
227
+ } else if (s === "closing") {
228
+ ctx.setState("closed");
229
+ clearAnimInline();
230
+ }
231
+ };
232
+
233
+ createEffect(() => {
234
+ const node = ctx.contentRef();
235
+ if (!node) return;
236
+ const handle = attachDrag({
237
+ el: node,
238
+ getState: ctx.state,
239
+ setState: ctx.setState,
240
+ requestClose: () => ctx.setOpen(false),
241
+ });
242
+ onCleanup(() => handle.destroy());
243
+ });
244
+
245
+ createEffect(() => {
246
+ const node = ctx.contentRef();
247
+ if (!node) return;
248
+ if (ctx.state() === "closed") return;
249
+ const handle = watchKeyboard(node);
250
+ onCleanup(() => handle.destroy());
251
+ });
252
+
253
+ createEffect(() => {
254
+ const s = ctx.state();
255
+ if (s !== "open" && s !== "opening") return;
256
+ if (!el) return;
257
+ const handle = trapFocus(el, local.initialFocus ?? "container");
258
+ onCleanup(() => handle.release());
259
+ });
260
+
261
+ createEffect(() => {
262
+ if (ctx.state() === "closed") return;
263
+ const onKey = (e: KeyboardEvent) => {
264
+ if (e.key !== "Escape") return;
265
+ if (!ctx.dismissible()) return;
266
+ e.preventDefault();
267
+ ctx.setOpen(false);
268
+ };
269
+ document.addEventListener("keydown", onKey);
270
+ onCleanup(() => document.removeEventListener("keydown", onKey));
271
+ });
272
+
273
+ // setTimeout(0) lets the click that opened the sheet finish bubbling
274
+ // before the dismiss listener is attached. Touch defers to `click` so
275
+ // drag/scroll intent can be detected first.
276
+ createEffect(() => {
277
+ if (ctx.state() === "closed") return;
278
+ if (!ctx.dismissible()) return;
279
+
280
+ let attached = false;
281
+ let pendingClick: ((e: MouseEvent) => void) | null = null;
282
+
283
+ const PORTAL_LAYER_SELECTOR =
284
+ '[data-kb-top-layer], [role="dialog"], [role="menu"], [role="listbox"], [role="combobox"], [role="tooltip"]';
285
+ const isOutside = (target: EventTarget | null): boolean => {
286
+ if (!(target instanceof Element) || !el) return false;
287
+ if (el.contains(target)) return false;
288
+ if (target.closest("[data-sheet-content]")) return false;
289
+ if (target.closest(PORTAL_LAYER_SELECTOR)) return false;
290
+ return true;
291
+ };
292
+
293
+ const onPointerDown = (e: PointerEvent) => {
294
+ if (!isOutside(e.target)) return;
295
+ const dismiss = () => {
296
+ if (ctx.state() === "open") ctx.setOpen(false);
297
+ };
298
+ if (e.pointerType === "touch") {
299
+ if (pendingClick) document.removeEventListener("click", pendingClick);
300
+ pendingClick = () => {
301
+ dismiss();
302
+ pendingClick = null;
303
+ };
304
+ document.addEventListener("click", pendingClick, { once: true });
305
+ } else {
306
+ dismiss();
307
+ }
308
+ };
309
+
310
+ const timer = window.setTimeout(() => {
311
+ document.addEventListener("pointerdown", onPointerDown, true);
312
+ attached = true;
313
+ }, 0);
314
+
315
+ onCleanup(() => {
316
+ window.clearTimeout(timer);
317
+ if (attached) document.removeEventListener("pointerdown", onPointerDown, true);
318
+ if (pendingClick) document.removeEventListener("click", pendingClick);
319
+ });
320
+ });
321
+
322
+ const setRef = (node: HTMLDivElement) => {
323
+ el = node;
324
+ ctx.setContentRef(node);
325
+ };
326
+
327
+ onCleanup(() => {
328
+ ctx.setContentRef(undefined);
329
+ });
330
+
331
+ const prefersReducedMotion = () =>
332
+ typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
333
+
334
+ return (
335
+ <ModalLabelsProvider value={labels}>
336
+ <div
337
+ {...rest}
338
+ ref={setRef}
339
+ role="dialog"
340
+ aria-modal="true"
341
+ aria-label={labels.labelledBy() ? undefined : local.ariaLabel}
342
+ aria-labelledby={labels.labelledBy()}
343
+ aria-describedby={labels.describedBy()}
344
+ tabIndex={-1}
345
+ data-slot="bottom-sheet-content"
346
+ data-sheet-content=""
347
+ data-state={ctx.state()}
348
+ data-reduced-motion={prefersReducedMotion() ? "" : undefined}
349
+ onAnimationEnd={onAnimationEnd}
350
+ onTransitionEnd={onTransitionEnd}
351
+ style={{
352
+ "z-index": Z.sheet,
353
+ "--bs-duration": `${TRANSITION_MS}ms`,
354
+ "--bs-ease": EASE,
355
+ "will-change": "transform",
356
+ "touch-action": "pan-y",
357
+ "-webkit-tap-highlight-color": "transparent",
358
+ }}
359
+ class={cn(
360
+ "bs-content",
361
+ `fixed inset-x-0 bottom-0 flex ${MODAL_MAX_H} flex-col rounded-t-xl ${OVERLAY_SURFACE_OPAQUE} outline-none`,
362
+ "after:absolute after:inset-x-0 after:top-full after:h-1/2 after:bg-inherit",
363
+ local.class,
364
+ )}
365
+ >
366
+ {local.children}
367
+ </div>
368
+ </ModalLabelsProvider>
369
+ );
370
+ };
371
+
372
+ const BottomSheetHandle: Component<ComponentProps<"div">> = (props) => {
373
+ const [local, rest] = splitProps(props, ["class"]);
374
+ return (
375
+ <div
376
+ data-slot="bottom-sheet-handle"
377
+ data-sheet-handle=""
378
+ aria-hidden="true"
379
+ class={cn(
380
+ "flex h-8 w-full shrink-0 touch-none select-none items-center justify-center",
381
+ local.class,
382
+ )}
383
+ {...rest}
384
+ >
385
+ <div class="h-1.5 w-12 rounded-full bg-muted-foreground/30" />
386
+ </div>
387
+ );
388
+ };
389
+
390
+ /* Only the Body: a titled, footed sheet is a ResponsiveDialog, which renders
391
+ * its own Header and Footer around this same surface. */
392
+ const {
393
+ Header: BottomSheetHeader,
394
+ Body: BottomSheetBody,
395
+ Footer: BottomSheetFooter,
396
+ } = createModalParts("bottom-sheet");
397
+
398
+ const BottomSheetTitle: Component<ComponentProps<"h2">> = (props) => {
399
+ const [local, rest] = splitProps(props, ["class"]);
400
+ const labels = useModalLabels();
401
+ const id = () => rest.id ?? labels?.titleId;
402
+ createRenderEffect(() => labels?.registerTitle(id()));
403
+ return (
404
+ <h2 data-slot="bottom-sheet-title" id={id()} class={cn(MODAL_TITLE, local.class)} {...rest} />
405
+ );
406
+ };
407
+
408
+ const BottomSheetDescription: Component<ComponentProps<"p">> = (props) => {
409
+ const [local, rest] = splitProps(props, ["class"]);
410
+ const labels = useModalLabels();
411
+ const id = () => rest.id ?? labels?.descriptionId;
412
+ createRenderEffect(() => labels?.registerDescription(id()));
413
+ return (
414
+ <p
415
+ data-slot="bottom-sheet-description"
416
+ id={id()}
417
+ class={cn(MODAL_DESCRIPTION, local.class)}
418
+ {...rest}
419
+ />
420
+ );
421
+ };
422
+
423
+ const BottomSheetClose: ParentComponent<SheetButtonProps> = (props) => {
424
+ const [local, rest] = splitProps(props, ["children", "onClick", "as"]);
425
+ const ctx = useBottomSheetContext();
426
+ const component = () => local.as ?? "button";
427
+ return (
428
+ <Dynamic
429
+ component={component()}
430
+ type={component() === "button" ? "button" : undefined}
431
+ data-slot="bottom-sheet-close"
432
+ onClick={(event: MouseEvent & { currentTarget: HTMLButtonElement; target: Element }) => {
433
+ callEventHandler(event, local.onClick);
434
+ ctx.setOpen(false);
435
+ }}
436
+ {...rest}
437
+ >
438
+ {local.children}
439
+ </Dynamic>
440
+ );
441
+ };
442
+
443
+ /** @deprecated the shared modal parts; `BottomSheetHeader` and `BottomSheetFooter` stay as aliases. */
444
+ export {
445
+ BottomSheet,
446
+ BottomSheetBody,
447
+ BottomSheetClose,
448
+ BottomSheetContent,
449
+ BottomSheetDescription,
450
+ BottomSheetFooter,
451
+ BottomSheetHandle,
452
+ BottomSheetHeader,
453
+ BottomSheetOverlay,
454
+ BottomSheetPortal,
455
+ BottomSheetTitle,
456
+ BottomSheetTrigger,
457
+ };
@@ -0,0 +1,8 @@
1
+ export const EASE = "cubic-bezier(0.32, 0.72, 0, 1)";
2
+ export const TRANSITION_MS = 500;
3
+
4
+ export const DEAD_ZONE_PX = 6;
5
+ export const CLOSE_DISTANCE_RATIO = 0.4;
6
+ export const CLOSE_VELOCITY_PX_PER_MS = 0.5;
7
+ export const VELOCITY_WINDOW_MS = 100;
8
+ export const VELOCITY_PROJECTION_MS = 200;
@@ -0,0 +1,221 @@
1
+ import { hasNoDragAncestor, shouldDrag } from "./arbitration.js";
2
+ import {
3
+ CLOSE_DISTANCE_RATIO,
4
+ CLOSE_VELOCITY_PX_PER_MS,
5
+ DEAD_ZONE_PX,
6
+ EASE,
7
+ TRANSITION_MS,
8
+ VELOCITY_PROJECTION_MS,
9
+ } from "./constants.js";
10
+ import type { SheetState } from "./state-machine.js";
11
+ import { VelocityTracker } from "./velocity.js";
12
+
13
+ const TRANSITION_CSS = `transform ${TRANSITION_MS}ms ${EASE}`;
14
+
15
+ interface DragHandle {
16
+ destroy: () => void;
17
+ }
18
+
19
+ interface DragOptions {
20
+ el: HTMLDivElement;
21
+ getState: () => SheetState;
22
+ setState: (s: SheetState) => void;
23
+ requestClose: () => void;
24
+ }
25
+
26
+ // Rubber-band dampening past the top snap. Vaul recipe.
27
+ function dampen(v: number): number {
28
+ return 8 * (Math.log(v + 1) - 2);
29
+ }
30
+
31
+ export function attachDrag(opts: DragOptions): DragHandle {
32
+ const { el, getState, setState, requestClose } = opts;
33
+ const tracker = new VelocityTracker();
34
+
35
+ let pointerId: number | null = null;
36
+ let startY = 0;
37
+ let startX = 0;
38
+ let pointerTarget: Element | null = null;
39
+ let dy = 0;
40
+ let raf = 0;
41
+ let pendingDy: number | null = null;
42
+ let movedPastDeadZone = false;
43
+ let dragAborted = false;
44
+ let height = 0;
45
+ let lastTotalDy = 0;
46
+
47
+ const isDraggableState = (): boolean => {
48
+ const s = getState();
49
+ return s === "open" || s === "pressing";
50
+ };
51
+
52
+ const flushFrame = () => {
53
+ raf = 0;
54
+ if (pendingDy === null) return;
55
+ const value = pendingDy;
56
+ pendingDy = null;
57
+ const applied = value < 0 ? dampen(-value) * -1 : value;
58
+ el.style.transform = `translate3d(0, ${applied}px, 0)`;
59
+ };
60
+
61
+ const schedule = (newDy: number) => {
62
+ pendingDy = newDy;
63
+ if (raf === 0) raf = requestAnimationFrame(flushFrame);
64
+ };
65
+
66
+ const onPointerDown = (e: PointerEvent) => {
67
+ if (e.button !== 0 && e.pointerType !== "touch") return;
68
+ if (!isDraggableState()) return;
69
+ if (pointerId !== null) return; // ignore secondary pointers
70
+
71
+ const target = e.target instanceof Element ? e.target : null;
72
+ if (hasNoDragAncestor(target, el)) return;
73
+ if (target && target.closest("[data-sheet-content]") !== el) return;
74
+
75
+ pointerId = e.pointerId;
76
+ startY = e.clientY;
77
+ startX = e.clientX;
78
+ pointerTarget = target;
79
+ dy = 0;
80
+ lastTotalDy = 0;
81
+ movedPastDeadZone = false;
82
+ dragAborted = false;
83
+ tracker.reset();
84
+ tracker.add(0, e.timeStamp);
85
+ height = el.offsetHeight || el.getBoundingClientRect().height;
86
+ setState("pressing");
87
+ };
88
+
89
+ const commitDrag = () => {
90
+ movedPastDeadZone = true;
91
+ if (pointerId !== null) {
92
+ try {
93
+ el.setPointerCapture(pointerId);
94
+ } catch {
95
+ /* pointer already released */
96
+ }
97
+ }
98
+ el.style.transition = "none";
99
+ el.style.animation = "none";
100
+ setState("dragging");
101
+ };
102
+
103
+ const onPointerMove = (e: PointerEvent) => {
104
+ if (e.pointerId !== pointerId) return;
105
+ if (dragAborted) return;
106
+ const totalDy = e.clientY - startY;
107
+ const totalDx = e.clientX - startX;
108
+ lastTotalDy = totalDy;
109
+
110
+ if (!movedPastDeadZone) {
111
+ if (Math.abs(totalDy) + Math.abs(totalDx) < DEAD_ZONE_PX) return;
112
+ if (!shouldDrag(pointerTarget, el, totalDy, totalDx)) {
113
+ dragAborted = true;
114
+ if (getState() === "pressing") setState("open");
115
+ return;
116
+ }
117
+ commitDrag();
118
+ }
119
+ tracker.add(totalDy, e.timeStamp);
120
+ dy = totalDy;
121
+ schedule(dy);
122
+ };
123
+
124
+ const cleanupDrag = () => {
125
+ if (raf !== 0) {
126
+ cancelAnimationFrame(raf);
127
+ raf = 0;
128
+ }
129
+ pendingDy = null;
130
+ pointerId = null;
131
+ pointerTarget = null;
132
+ dragAborted = false;
133
+ };
134
+
135
+ const settleClose = () => {
136
+ el.style.transition = TRANSITION_CSS;
137
+ el.style.animation = "none";
138
+ el.style.transform = "translate3d(0, 100%, 0)";
139
+ requestClose();
140
+ };
141
+
142
+ const settleSnap = () => {
143
+ setState("snapping");
144
+ el.style.transition = TRANSITION_CSS;
145
+ el.style.animation = "";
146
+ el.style.transform = "translate3d(0, 0, 0)";
147
+ };
148
+
149
+ const suppressNextClick = () => {
150
+ const onClick = (e: MouseEvent) => {
151
+ e.preventDefault();
152
+ e.stopPropagation();
153
+ document.removeEventListener("click", onClick, true);
154
+ };
155
+ document.addEventListener("click", onClick, true);
156
+ setTimeout(() => document.removeEventListener("click", onClick, true), 100);
157
+ };
158
+
159
+ const safeReleaseCapture = () => {
160
+ if (pointerId === null) return;
161
+ try {
162
+ if (el.hasPointerCapture(pointerId)) el.releasePointerCapture(pointerId);
163
+ } catch {
164
+ /* pointer already gone */
165
+ }
166
+ };
167
+
168
+ const onPointerUp = (e: PointerEvent) => {
169
+ if (e.pointerId !== pointerId) return;
170
+ const wasDragging = movedPastDeadZone;
171
+ safeReleaseCapture();
172
+
173
+ if (!wasDragging) {
174
+ cleanupDrag();
175
+ setState("open");
176
+ return;
177
+ }
178
+
179
+ const velocity = tracker.compute(e.timeStamp);
180
+ const projectedDy = dy + velocity * VELOCITY_PROJECTION_MS;
181
+ const shouldClose =
182
+ projectedDy > height * CLOSE_DISTANCE_RATIO || velocity > CLOSE_VELOCITY_PX_PER_MS;
183
+
184
+ if (Math.abs(lastTotalDy) > DEAD_ZONE_PX) suppressNextClick();
185
+
186
+ cleanupDrag();
187
+ if (shouldClose) settleClose();
188
+ else settleSnap();
189
+ };
190
+
191
+ const onPointerCancel = (e: PointerEvent) => {
192
+ if (e.pointerId !== pointerId) return;
193
+ safeReleaseCapture();
194
+ const wasDragging = movedPastDeadZone;
195
+ cleanupDrag();
196
+ if (wasDragging) settleSnap();
197
+ else setState("open");
198
+ };
199
+
200
+ // preventDefault while drag committed — stops browser converting to scroll.
201
+ const onTouchMove = (e: TouchEvent) => {
202
+ if (movedPastDeadZone) e.preventDefault();
203
+ };
204
+
205
+ el.addEventListener("pointerdown", onPointerDown);
206
+ el.addEventListener("pointermove", onPointerMove);
207
+ el.addEventListener("pointerup", onPointerUp);
208
+ el.addEventListener("pointercancel", onPointerCancel);
209
+ el.addEventListener("touchmove", onTouchMove, { passive: false });
210
+
211
+ return {
212
+ destroy() {
213
+ el.removeEventListener("pointerdown", onPointerDown);
214
+ el.removeEventListener("pointermove", onPointerMove);
215
+ el.removeEventListener("pointerup", onPointerUp);
216
+ el.removeEventListener("pointercancel", onPointerCancel);
217
+ el.removeEventListener("touchmove", onTouchMove);
218
+ cleanupDrag();
219
+ },
220
+ };
221
+ }