@c9up/nebula 0.1.9 → 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.
Files changed (122) hide show
  1. package/dist/atoms/Avatar.d.ts +36 -9
  2. package/dist/atoms/Avatar.js +66 -27
  3. package/dist/atoms/index.d.ts +1 -1
  4. package/dist/atoms/index.js +1 -1
  5. package/dist/lib/children.d.ts +30 -0
  6. package/dist/lib/motion.d.ts +10 -0
  7. package/dist/lib/motion.js +10 -0
  8. package/dist/molecules/Accordion.d.ts +36 -15
  9. package/dist/molecules/Accordion.js +68 -45
  10. package/dist/molecules/Breadcrumb.d.ts +29 -11
  11. package/dist/molecules/Breadcrumb.js +52 -52
  12. package/dist/molecules/Collapsible.d.ts +18 -17
  13. package/dist/molecules/Collapsible.js +42 -34
  14. package/dist/molecules/Field.d.ts +66 -30
  15. package/dist/molecules/Field.js +106 -55
  16. package/dist/molecules/InputGroup.d.ts +39 -21
  17. package/dist/molecules/InputGroup.js +43 -27
  18. package/dist/molecules/InputOTP.d.ts +26 -3
  19. package/dist/molecules/InputOTP.js +109 -76
  20. package/dist/molecules/Message.js +5 -4
  21. package/dist/molecules/Pagination.d.ts +36 -11
  22. package/dist/molecules/Pagination.js +58 -74
  23. package/dist/molecules/RadioGroup.d.ts +25 -17
  24. package/dist/molecules/RadioGroup.js +47 -43
  25. package/dist/molecules/Resizable.d.ts +32 -7
  26. package/dist/molecules/Resizable.js +76 -49
  27. package/dist/molecules/Tabs.d.ts +49 -11
  28. package/dist/molecules/Tabs.js +107 -51
  29. package/dist/molecules/ToggleGroup.d.ts +16 -10
  30. package/dist/molecules/ToggleGroup.js +37 -21
  31. package/dist/molecules/index.d.ts +11 -11
  32. package/dist/molecules/index.js +11 -11
  33. package/dist/organisms/AlertDialog.d.ts +80 -28
  34. package/dist/organisms/AlertDialog.js +192 -67
  35. package/dist/organisms/Carousel.d.ts +25 -3
  36. package/dist/organisms/Carousel.js +75 -43
  37. package/dist/organisms/Combobox.d.ts +2 -1
  38. package/dist/organisms/Combobox.js +46 -16
  39. package/dist/organisms/Command.d.ts +73 -32
  40. package/dist/organisms/Command.js +209 -131
  41. package/dist/organisms/CommandDialog.js +5 -5
  42. package/dist/organisms/ContextMenu.d.ts +41 -19
  43. package/dist/organisms/ContextMenu.js +112 -71
  44. package/dist/organisms/DataTable.js +42 -8
  45. package/dist/organisms/Dialog.d.ts +97 -31
  46. package/dist/organisms/Dialog.js +193 -68
  47. package/dist/organisms/Drawer.d.ts +33 -10
  48. package/dist/organisms/Drawer.js +130 -52
  49. package/dist/organisms/DropdownMenu.d.ts +58 -11
  50. package/dist/organisms/DropdownMenu.js +137 -50
  51. package/dist/organisms/Form.js +9 -11
  52. package/dist/organisms/HoverCard.d.ts +39 -19
  53. package/dist/organisms/HoverCard.js +116 -40
  54. package/dist/organisms/Menubar.d.ts +55 -19
  55. package/dist/organisms/Menubar.js +166 -82
  56. package/dist/organisms/NavigationMenu.d.ts +77 -31
  57. package/dist/organisms/NavigationMenu.js +169 -98
  58. package/dist/organisms/Popover.d.ts +72 -12
  59. package/dist/organisms/Popover.js +132 -25
  60. package/dist/organisms/Questionnaire.js +5 -5
  61. package/dist/organisms/Select.d.ts +99 -18
  62. package/dist/organisms/Select.js +253 -111
  63. package/dist/organisms/Sheet.d.ts +57 -13
  64. package/dist/organisms/Sheet.js +141 -54
  65. package/dist/organisms/Sidebar.d.ts +146 -56
  66. package/dist/organisms/Sidebar.js +236 -128
  67. package/dist/organisms/Tooltip.d.ts +88 -14
  68. package/dist/organisms/Tooltip.js +210 -47
  69. package/dist/organisms/index.d.ts +15 -15
  70. package/dist/organisms/index.js +15 -15
  71. package/dist/primitives/floating.js +25 -0
  72. package/dist/primitives/floatingSurface.d.ts +11 -0
  73. package/dist/primitives/floatingSurface.js +8 -0
  74. package/dist/primitives/menu.d.ts +45 -1
  75. package/dist/primitives/menu.js +45 -14
  76. package/dist/primitives/menuParts.d.ts +113 -0
  77. package/dist/primitives/menuParts.js +207 -0
  78. package/nebula.css +1 -1
  79. package/package.json +3 -3
  80. package/registry.json +18 -6
  81. package/src/atoms/Avatar.ts +141 -37
  82. package/src/atoms/index.ts +13 -1
  83. package/src/lib/children.ts +31 -0
  84. package/src/lib/motion.ts +12 -0
  85. package/src/molecules/Accordion.ts +120 -60
  86. package/src/molecules/Breadcrumb.ts +77 -76
  87. package/src/molecules/Collapsible.ts +77 -41
  88. package/src/molecules/Field.ts +187 -72
  89. package/src/molecules/InputGroup.ts +88 -35
  90. package/src/molecules/InputOTP.ts +150 -86
  91. package/src/molecules/Message.ts +6 -4
  92. package/src/molecules/Pagination.ts +96 -101
  93. package/src/molecules/RadioGroup.ts +70 -59
  94. package/src/molecules/Resizable.ts +138 -75
  95. package/src/molecules/Tabs.ts +187 -74
  96. package/src/molecules/ToggleGroup.ts +77 -38
  97. package/src/molecules/index.ts +85 -8
  98. package/src/organisms/AlertDialog.ts +319 -82
  99. package/src/organisms/Carousel.ts +129 -52
  100. package/src/organisms/Combobox.ts +64 -19
  101. package/src/organisms/Command.ts +342 -159
  102. package/src/organisms/CommandDialog.ts +6 -6
  103. package/src/organisms/ContextMenu.ts +185 -83
  104. package/src/organisms/DataTable.ts +56 -10
  105. package/src/organisms/Dialog.ts +312 -102
  106. package/src/organisms/Drawer.ts +219 -71
  107. package/src/organisms/DropdownMenu.ts +219 -61
  108. package/src/organisms/Form.ts +48 -34
  109. package/src/organisms/HoverCard.ts +187 -53
  110. package/src/organisms/Menubar.ts +247 -87
  111. package/src/organisms/NavigationMenu.ts +306 -128
  112. package/src/organisms/Popover.ts +215 -39
  113. package/src/organisms/Questionnaire.ts +9 -6
  114. package/src/organisms/Select.ts +397 -130
  115. package/src/organisms/Sheet.ts +252 -83
  116. package/src/organisms/Sidebar.ts +438 -185
  117. package/src/organisms/Tooltip.ts +315 -65
  118. package/src/organisms/index.ts +284 -14
  119. package/src/primitives/floating.ts +33 -0
  120. package/src/primitives/floatingSurface.ts +19 -0
  121. package/src/primitives/menu.ts +79 -18
  122. package/src/primitives/menuParts.ts +371 -0
@@ -39,7 +39,13 @@ import type { Child, Slot } from "../lib/children.js";
39
39
  import { slot } from "../lib/children.js";
40
40
  import { cn } from "../lib/cn.js";
41
41
  import { type Reactive, read } from "../lib/props.js";
42
- import { Field, fieldIds } from "../molecules/Field.js";
42
+ import {
43
+ Field,
44
+ FieldDescription,
45
+ FieldError,
46
+ FieldLabel,
47
+ fieldIds,
48
+ } from "../molecules/Field.js";
43
49
 
44
50
  /**
45
51
  * One field, with a setter that already knows which key it writes to.
@@ -138,25 +144,29 @@ export const TextField = component<TextFieldProps>((props) => {
138
144
 
139
145
  return Field({
140
146
  ids,
141
- label: props.label,
142
- description: props.description,
143
- error: visibleError,
144
147
  required: props.required,
145
148
  disabled: props.disabled,
146
- children: Input({
147
- id: ids.control,
148
- name,
149
- type: props.type ?? "text",
150
- placeholder: props.placeholder,
151
- autocomplete: props.autocomplete,
152
- required: props.required,
153
- disabled: props.disabled,
154
- invalid: () => visibleError() !== undefined,
155
- describedBy: ids.describedBy,
156
- value: () => field.value(),
157
- onInput: set,
158
- onBlur: () => field.markTouched(),
159
- }),
149
+ children: () =>
150
+ html`${
151
+ props.label === undefined ? null : FieldLabel({ children: props.label })
152
+ }${Input({
153
+ id: ids.control,
154
+ name,
155
+ type: props.type ?? "text",
156
+ placeholder: props.placeholder,
157
+ autocomplete: props.autocomplete,
158
+ required: props.required,
159
+ disabled: props.disabled,
160
+ invalid: () => visibleError() !== undefined,
161
+ describedBy: ids.describedBy,
162
+ value: () => field.value(),
163
+ onInput: set,
164
+ onBlur: () => field.markTouched(),
165
+ })}${
166
+ props.description === undefined
167
+ ? null
168
+ : FieldDescription({ children: props.description })
169
+ }${FieldError({ children: visibleError })}`,
160
170
  });
161
171
  });
162
172
 
@@ -173,24 +183,28 @@ export const TextAreaField = component<TextAreaFieldProps>((props) => {
173
183
 
174
184
  return Field({
175
185
  ids,
176
- label: props.label,
177
- description: props.description,
178
- error: visibleError,
179
186
  required: props.required,
180
187
  disabled: props.disabled,
181
- children: Textarea({
182
- id: ids.control,
183
- name,
184
- rows: props.rows,
185
- placeholder: props.placeholder,
186
- required: props.required,
187
- disabled: props.disabled,
188
- invalid: () => visibleError() !== undefined,
189
- describedBy: ids.describedBy,
190
- value: () => field.value(),
191
- onInput: set,
192
- onBlur: () => field.markTouched(),
193
- }),
188
+ children: () =>
189
+ html`${
190
+ props.label === undefined ? null : FieldLabel({ children: props.label })
191
+ }${Textarea({
192
+ id: ids.control,
193
+ name,
194
+ rows: props.rows,
195
+ placeholder: props.placeholder,
196
+ required: props.required,
197
+ disabled: props.disabled,
198
+ invalid: () => visibleError() !== undefined,
199
+ describedBy: ids.describedBy,
200
+ value: () => field.value(),
201
+ onInput: set,
202
+ onBlur: () => field.markTouched(),
203
+ })}${
204
+ props.description === undefined
205
+ ? null
206
+ : FieldDescription({ children: props.description })
207
+ }${FieldError({ children: visibleError })}`,
194
208
  });
195
209
  });
196
210
 
@@ -1,92 +1,226 @@
1
1
  /**
2
- * HoverCard — a rich preview shown on hover.
2
+ * HoverCard — a preview that appears when the pointer rests on a link.
3
3
  *
4
- * A Tooltip carries a phrase; a HoverCard carries content — an avatar, a
5
- * summary, a link. That difference drives every behavioural difference between
6
- * the two.
4
+ * HoverCard({ children: () => html`
5
+ * ${HoverCardTrigger({ children: "@nebula" })}
6
+ * ${HoverCardContent({ children: "…" })}
7
+ * ` })
7
8
  *
8
- * It opens more slowly, because the payload is heavier and a card flashing
9
- * past is worse than a tooltip flashing past. It closes more slowly, because
10
- * the user is expected to move the pointer *into* it. And it is never the only
11
- * route to what it contains: pointer-only content is unreachable by keyboard
12
- * and touch, so a hover card must preview something a click already reaches.
9
+ * Longer delays than a Tooltip, in both directions, and for different reasons.
10
+ * Opening is slow because a hover card is a heavier interruption than a label
11
+ * — it covers content, so it should appear only on a deliberate rest. Closing
12
+ * is slow because the card is meant to be entered: it holds links.
13
13
  *
14
- * `role="dialog"` rather than `tooltip`, since it holds interactive content —
15
- * a tooltip's contents are announced as a description, which is wrong for
16
- * something containing a link.
14
+ * `role="dialog"`, not `role="tooltip"`. A tooltip is a label and must contain
15
+ * nothing interactive; a hover card is a small window that may.
17
16
  */
18
17
 
19
- import { component, html, onUnmount, signal } from "@c9up/aurora";
20
- import { type Slot, slot } from "../lib/children.js";
18
+ import {
19
+ component,
20
+ createContext,
21
+ html,
22
+ inject,
23
+ onUnmount,
24
+ provide,
25
+ type TemplateResult,
26
+ } from "@c9up/aurora";
27
+ import type { Child, Parts, Slot } from "../lib/children.js";
28
+ import { slot } from "../lib/children.js";
21
29
  import { cn } from "../lib/cn.js";
22
30
  import { uid } from "../lib/id.js";
23
- import { zoomInOut } from "../lib/motion.js";
31
+ import { slideInFromSide, zoomInOut } from "../lib/motion.js";
24
32
  import { type Reactive, read } from "../lib/props.js";
25
- import type { Placement } from "../primitives/floating.js";
33
+ import { controllable } from "../primitives/controllable.js";
34
+ import type { Align, Placement, Side } from "../primitives/floating.js";
26
35
  import { floatingSurface } from "../primitives/floatingSurface.js";
27
36
 
28
37
  const OPEN_DELAY_MS = 700;
29
38
  const CLOSE_DELAY_MS = 300;
30
39
 
40
+ interface RegisteredContent {
41
+ readonly body: Child;
42
+ readonly side: Side;
43
+ readonly align: Align;
44
+ readonly sideOffset: number;
45
+ readonly class?: Reactive<string>;
46
+ }
47
+
48
+ interface HoverCardApi {
49
+ readonly triggerId: string;
50
+ readonly contentId: string;
51
+ readonly open: () => boolean;
52
+ scheduleOpen(): void;
53
+ scheduleClose(): void;
54
+ cancelPending(): void;
55
+ register(content: RegisteredContent): void;
56
+ }
57
+
58
+ const HoverCardContext = createContext<HoverCardApi>("HoverCard");
59
+
31
60
  export interface HoverCardProps {
32
- trigger?: Slot;
33
- children?: Slot;
34
- placement?: Placement;
61
+ open?: Reactive<boolean>;
62
+ defaultOpen?: boolean;
63
+ onOpenChange?: (open: boolean) => void;
35
64
  openDelay?: number;
36
65
  closeDelay?: number;
37
- class?: Reactive<string>;
38
- contentClass?: Reactive<string>;
66
+ children?: Parts;
39
67
  }
40
68
 
41
69
  export const HoverCard = component<HoverCardProps>((props) => {
42
70
  const triggerId = uid("hover-card-trigger");
43
71
  const contentId = uid("hover-card-content");
44
- const open = signal(false);
45
-
72
+ let content: RegisteredContent | undefined;
46
73
  let timer: ReturnType<typeof setTimeout> | undefined;
47
74
 
48
- function clear(): void {
75
+ const state = controllable<boolean>({
76
+ value: props.open,
77
+ initial: props.defaultOpen ?? false,
78
+ onChange: props.onOpenChange,
79
+ });
80
+
81
+ function cancelPending(): void {
49
82
  if (timer !== undefined) clearTimeout(timer);
50
83
  timer = undefined;
51
84
  }
52
85
 
53
86
  function schedule(next: boolean, delay: number): void {
54
- clear();
55
- timer = setTimeout(() => open(next), delay);
87
+ cancelPending();
88
+ timer = setTimeout(() => state.set(next), delay);
56
89
  }
57
90
 
58
- onUnmount(clear);
91
+ onUnmount(cancelPending);
59
92
 
60
- floatingSurface({
61
- anchor: () => document.getElementById(triggerId),
62
- open: () => open(),
63
- onClose: () => {
64
- clear();
65
- open(false);
93
+ provide<HoverCardApi>(HoverCardContext, {
94
+ triggerId,
95
+ contentId,
96
+ open: () => state.current(),
97
+ scheduleOpen: () => schedule(true, props.openDelay ?? OPEN_DELAY_MS),
98
+ scheduleClose: () => schedule(false, props.closeDelay ?? CLOSE_DELAY_MS),
99
+ cancelPending,
100
+ register(registered) {
101
+ content = registered;
66
102
  },
67
- placement: props.placement ?? "bottom",
68
- offset: 8,
69
- content: () =>
70
- html`<div
71
- data-slot="hover-card-content"
72
- id="${contentId}"
73
- role="dialog"
74
- aria-labelledby="${triggerId}"
75
- class="${cn(
76
- "bg-popover text-popover-foreground z-50 w-64 rounded-md border p-4 shadow-md outline-none",
77
- zoomInOut,
78
- read(props.contentClass),
79
- )}"
80
- @pointerenter="${clear}"
81
- @pointerleave="${() => schedule(false, props.closeDelay ?? CLOSE_DELAY_MS)}"
82
- >${slot(props.children)}</div>`,
83
103
  });
84
104
 
105
+ const parts = props.children?.();
106
+
107
+ if (content !== undefined) {
108
+ const registered = content;
109
+ const placement: Placement =
110
+ registered.align === "center"
111
+ ? registered.side
112
+ : `${registered.side}-${registered.align}`;
113
+ floatingSurface({
114
+ anchor: () => document.getElementById(triggerId),
115
+ open: () => state.current(),
116
+ onClose: () => {
117
+ cancelPending();
118
+ state.set(false);
119
+ },
120
+ placement,
121
+ offset: registered.sideOffset,
122
+ content: () =>
123
+ renderContent(registered, {
124
+ contentId,
125
+ triggerId,
126
+ enter: cancelPending,
127
+ leave: () => schedule(false, props.closeDelay ?? CLOSE_DELAY_MS),
128
+ }),
129
+ });
130
+ }
131
+
132
+ return html`${parts}`;
133
+ });
134
+
135
+ export interface HoverCardTriggerProps {
136
+ children?: Slot;
137
+ href?: string;
138
+ class?: Reactive<string>;
139
+ }
140
+
141
+ /**
142
+ * What the pointer rests on.
143
+ *
144
+ * An `<a>` when given an `href`, a `<span>` otherwise — upstream is used with
145
+ * `asChild` around a link, and a `<span>` wrapping one would put the hover
146
+ * target and the link in different elements.
147
+ */
148
+ export const HoverCardTrigger = component<HoverCardTriggerProps>((props) => {
149
+ const card = inject(HoverCardContext);
150
+ const shared = {
151
+ id: card.triggerId,
152
+ open: () => card.open(),
153
+ };
154
+ if (props.href !== undefined) {
155
+ return html`<a
156
+ data-slot="hover-card-trigger"
157
+ id="${shared.id}"
158
+ href="${props.href}"
159
+ data-state="${() => (shared.open() ? "open" : "closed")}"
160
+ class="${() => cn(read(props.class))}"
161
+ @pointerenter="${() => card.scheduleOpen()}"
162
+ @pointerleave="${() => card.scheduleClose()}"
163
+ @focusin="${() => card.scheduleOpen()}"
164
+ @focusout="${() => card.scheduleClose()}"
165
+ >${slot(props.children)}</a>`;
166
+ }
85
167
  return html`<span
86
168
  data-slot="hover-card-trigger"
87
- id="${triggerId}"
169
+ id="${shared.id}"
170
+ data-state="${() => (shared.open() ? "open" : "closed")}"
88
171
  class="${() => cn("inline-flex", read(props.class))}"
89
- @pointerenter="${() => schedule(true, props.openDelay ?? OPEN_DELAY_MS)}"
90
- @pointerleave="${() => schedule(false, props.closeDelay ?? CLOSE_DELAY_MS)}"
91
- >${slot(props.trigger)}</span>`;
172
+ @pointerenter="${() => card.scheduleOpen()}"
173
+ @pointerleave="${() => card.scheduleClose()}"
174
+ @focusin="${() => card.scheduleOpen()}"
175
+ @focusout="${() => card.scheduleClose()}"
176
+ >${slot(props.children)}</span>`;
92
177
  });
178
+
179
+ export interface HoverCardContentProps {
180
+ children?: Slot;
181
+ side?: Side;
182
+ align?: Align;
183
+ sideOffset?: number;
184
+ class?: Reactive<string>;
185
+ }
186
+
187
+ export const HoverCardContent = component<HoverCardContentProps>((props) => {
188
+ const card = inject(HoverCardContext);
189
+ card.register({
190
+ body: slot(props.children)(),
191
+ side: props.side ?? "bottom",
192
+ align: props.align ?? "center",
193
+ sideOffset: props.sideOffset ?? 8,
194
+ class: props.class,
195
+ });
196
+ return html``;
197
+ });
198
+
199
+ interface ContentHandlers {
200
+ readonly contentId: string;
201
+ readonly triggerId: string;
202
+ enter(): void;
203
+ leave(): void;
204
+ }
205
+
206
+ function renderContent(
207
+ registered: RegisteredContent,
208
+ handlers: ContentHandlers,
209
+ ): TemplateResult {
210
+ // The card stays open while the pointer is inside it, which is the only way
211
+ // to reach the links it exists to show.
212
+ return html`<div
213
+ data-slot="hover-card-content"
214
+ id="${handlers.contentId}"
215
+ role="dialog"
216
+ aria-labelledby="${handlers.triggerId}"
217
+ class="${cn(
218
+ "bg-popover text-popover-foreground z-50 w-64 origin-(--nebula-transform-origin) rounded-md border p-4 shadow-md outline-hidden",
219
+ zoomInOut,
220
+ slideInFromSide,
221
+ read(registered.class),
222
+ )}"
223
+ @pointerenter="${() => handlers.enter()}"
224
+ @pointerleave="${() => handlers.leave()}"
225
+ >${registered.body}</div>`;
226
+ }