@c9up/nebula 0.1.8 → 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 +5 -4
  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
@@ -5,45 +5,87 @@
5
5
  * anchored overlays in this directory are this component with a different
6
6
  * opening gesture and different contents.
7
7
  *
8
+ * Popover({ children: () => html`
9
+ * ${PopoverTrigger({ children: "Open" })}
10
+ * ${PopoverContent({ children: () => html`
11
+ * ${PopoverHeader({ children: () => html`
12
+ * ${PopoverTitle({ children: "Dimensions" })}
13
+ * ${PopoverDescription({ children: "Set the box size." })}
14
+ * ` })}
15
+ * ` })}
16
+ * ` })
17
+ *
18
+ * The `() =>` on a part that provides context is load-bearing — see `Parts`.
19
+ * The purely presentational parts below take ordinary children.
20
+ *
8
21
  * `modal` decides whether focus is trapped. A popover holding a form should
9
22
  * trap — tabbing out of a half-filled form into the page behind loses the
10
23
  * user's place. A popover holding a paragraph of help should not, because
11
24
  * trapping focus in something the user can only read is a dead end.
12
25
  */
13
26
 
14
- import { component, html } from "@c9up/aurora";
15
- import { type Slot, slot } from "../lib/children.js";
27
+ import {
28
+ component,
29
+ createContext,
30
+ html,
31
+ inject,
32
+ provide,
33
+ type TemplateResult,
34
+ } from "@c9up/aurora";
35
+ import type { Child, Parts, Slot } from "../lib/children.js";
36
+ import { slot } from "../lib/children.js";
16
37
  import { cn } from "../lib/cn.js";
17
38
  import { uid } from "../lib/id.js";
18
- import { zoomInOut } from "../lib/motion.js";
39
+ import { slideInFromSide, zoomInOut } from "../lib/motion.js";
19
40
  import { type Reactive, read } from "../lib/props.js";
20
41
  import { controllable } from "../primitives/controllable.js";
21
- import type { Placement } from "../primitives/floating.js";
42
+ import type { Align, Placement, Side } from "../primitives/floating.js";
22
43
  import { floatingSurface } from "../primitives/floatingSurface.js";
23
44
 
24
45
  export const popoverContentClasses =
25
- "bg-popover text-popover-foreground z-50 w-72 rounded-md border p-4 shadow-md outline-none";
46
+ "bg-popover text-popover-foreground z-50 w-72 origin-(--nebula-transform-origin) rounded-md border p-4 shadow-md outline-hidden";
47
+
48
+ interface RegisteredContent {
49
+ readonly render: () => Child;
50
+ readonly side: Side;
51
+ readonly align: Align;
52
+ readonly sideOffset: number;
53
+ readonly modal: boolean;
54
+ readonly class?: Reactive<string>;
55
+ }
56
+
57
+ interface PopoverApi {
58
+ readonly triggerId: string;
59
+ readonly contentId: string;
60
+ readonly open: () => boolean;
61
+ toggle(): void;
62
+ setOpen(next: boolean): void;
63
+ /** An explicit anchor wins over the trigger — see `PopoverAnchor`. */
64
+ useAnchor(id: string): void;
65
+ register(content: RegisteredContent): void;
66
+ }
67
+
68
+ const PopoverContext = createContext<PopoverApi>("Popover");
26
69
 
27
70
  export interface PopoverProps {
28
- /** Rendered inside the trigger button. */
29
- trigger?: Slot;
30
- /** The panel's contents. */
31
- children?: Slot;
32
71
  open?: Reactive<boolean>;
33
72
  defaultOpen?: boolean;
34
73
  onOpenChange?: (open: boolean) => void;
35
- placement?: Placement;
36
- offset?: number;
37
- /** Trap focus inside. Use for panels holding form controls. */
38
- modal?: boolean;
39
- class?: Reactive<string>;
40
- triggerClass?: Reactive<string>;
41
- contentClass?: Reactive<string>;
74
+ children?: Parts;
42
75
  }
43
76
 
77
+ /**
78
+ * The state its trigger and its content both read.
79
+ *
80
+ * Renders no element of its own, as upstream does not: a wrapper would put a
81
+ * box into a layout that did not ask for one, and `data-slot="popover"` is
82
+ * inert upstream for the same reason.
83
+ */
44
84
  export const Popover = component<PopoverProps>((props) => {
45
85
  const triggerId = uid("popover-trigger");
46
86
  const contentId = uid("popover-content");
87
+ let anchorId = triggerId;
88
+ let content: RegisteredContent | undefined;
47
89
 
48
90
  const state = controllable<boolean>({
49
91
  value: props.open,
@@ -51,34 +93,168 @@ export const Popover = component<PopoverProps>((props) => {
51
93
  onChange: props.onOpenChange,
52
94
  });
53
95
 
54
- floatingSurface({
55
- anchor: () => document.getElementById(triggerId),
96
+ provide<PopoverApi>(PopoverContext, {
97
+ triggerId,
98
+ contentId,
56
99
  open: () => state.current(),
57
- onClose: () => state.set(false),
58
- placement: props.placement ?? "bottom",
59
- offset: props.offset ?? 4,
60
- trapFocus: props.modal === true,
61
- autoFocus: props.modal !== true,
62
- content: () =>
63
- html`<div
64
- data-slot="popover-content"
65
- id="${contentId}"
66
- role="dialog"
67
- aria-labelledby="${triggerId}"
68
- tabindex="-1"
69
- class="${cn(popoverContentClasses, zoomInOut, read(props.contentClass))}"
70
- >${slot(props.children)}</div>`,
100
+ toggle: () => state.set(!state.current()),
101
+ setOpen: (next) => state.set(next),
102
+ useAnchor(id) {
103
+ anchorId = id;
104
+ },
105
+ register(registered) {
106
+ content = registered;
107
+ },
71
108
  });
72
109
 
110
+ // Built HERE so the parts see the context, and so the content has
111
+ // registered by the time the surface below needs it.
112
+ const parts = props.children?.();
113
+
114
+ if (content !== undefined) {
115
+ const registered = content;
116
+ const placement: Placement =
117
+ registered.align === "center"
118
+ ? registered.side
119
+ : `${registered.side}-${registered.align}`;
120
+ floatingSurface({
121
+ anchor: () => document.getElementById(anchorId),
122
+ open: () => state.current(),
123
+ onClose: () => state.set(false),
124
+ placement,
125
+ offset: registered.sideOffset,
126
+ trapFocus: registered.modal,
127
+ autoFocus: !registered.modal,
128
+ content: () => renderContent(registered, contentId, triggerId),
129
+ });
130
+ }
131
+
132
+ return html`${parts}`;
133
+ });
134
+
135
+ export interface PopoverTriggerProps {
136
+ children?: Slot;
137
+ class?: Reactive<string>;
138
+ }
139
+
140
+ export const PopoverTrigger = component<PopoverTriggerProps>((props) => {
141
+ const popover = inject(PopoverContext);
73
142
  return html`<button
74
143
  type="button"
75
144
  data-slot="popover-trigger"
76
- id="${triggerId}"
145
+ id="${popover.triggerId}"
77
146
  aria-haspopup="dialog"
78
- aria-expanded="${() => (state.current() ? "true" : "false")}"
79
- aria-controls="${() => (state.current() ? contentId : undefined)}"
80
- data-state="${() => (state.current() ? "open" : "closed")}"
81
- class="${() => cn(read(props.triggerClass))}"
82
- @click="${() => state.set(!state.current())}"
83
- >${slot(props.trigger)}</button>`;
147
+ aria-expanded="${() => (popover.open() ? "true" : "false")}"
148
+ aria-controls="${() => (popover.open() ? popover.contentId : undefined)}"
149
+ data-state="${() => (popover.open() ? "open" : "closed")}"
150
+ class="${() => cn(read(props.class))}"
151
+ @click="${() => popover.toggle()}"
152
+ >${slot(props.children)}</button>`;
153
+ });
154
+
155
+ export interface PopoverAnchorProps {
156
+ children?: Slot;
157
+ class?: Reactive<string>;
158
+ }
159
+
160
+ /**
161
+ * Position the panel against something other than the trigger.
162
+ *
163
+ * A cell menu whose button sits in the corner but whose panel should line up
164
+ * with the whole cell, or a mention popover anchored to a caret marker rather
165
+ * than to any control.
166
+ */
167
+ export const PopoverAnchor = component<PopoverAnchorProps>((props) => {
168
+ const popover = inject(PopoverContext);
169
+ const anchorId = uid("popover-anchor");
170
+ popover.useAnchor(anchorId);
171
+ return html`<span
172
+ data-slot="popover-anchor"
173
+ id="${anchorId}"
174
+ class="${() => cn(read(props.class))}"
175
+ >${slot(props.children)}</span>`;
84
176
  });
177
+
178
+ export interface PopoverContentProps {
179
+ children?: Slot;
180
+ /** Which edge of the anchor to sit on. Flips when there is no room. */
181
+ side?: Side;
182
+ align?: Align;
183
+ sideOffset?: number;
184
+ /** Trap focus inside. Use for panels holding form controls. */
185
+ modal?: boolean;
186
+ class?: Reactive<string>;
187
+ }
188
+
189
+ /**
190
+ * The panel.
191
+ *
192
+ * Renders nothing where it is written: the popover portals its content out of
193
+ * the tree when it opens, so this registers what to build and returns an empty
194
+ * template.
195
+ */
196
+ export const PopoverContent = component<PopoverContentProps>((props) => {
197
+ const popover = inject(PopoverContext);
198
+ popover.register({
199
+ render: () => slot(props.children)(),
200
+ side: props.side ?? "bottom",
201
+ align: props.align ?? "center",
202
+ sideOffset: props.sideOffset ?? 4,
203
+ modal: props.modal === true,
204
+ class: props.class,
205
+ });
206
+ return html``;
207
+ });
208
+
209
+ export interface PopoverSectionProps {
210
+ children?: Slot;
211
+ class?: Reactive<string>;
212
+ }
213
+
214
+ export const PopoverHeader = component<PopoverSectionProps>(
215
+ (props) => html`<div
216
+ data-slot="popover-header"
217
+ class="${() => cn("flex flex-col gap-1 text-sm", read(props.class))}"
218
+ >${slot(props.children)}</div>`,
219
+ );
220
+
221
+ /**
222
+ * NAMED DEVIATION — a `<div>`, matching what upstream RENDERS rather than what
223
+ * it types. shadcn declares `PopoverTitle` as `ComponentProps<"h2">` and then
224
+ * returns a `<div>`; a heading here would land inside a `role="dialog"` and
225
+ * change how a screen reader announces the panel, which is not a difference to
226
+ * introduce silently. The panel is already named by its trigger.
227
+ */
228
+ export const PopoverTitle = component<PopoverSectionProps>(
229
+ (props) => html`<div
230
+ data-slot="popover-title"
231
+ class="${() => cn("font-medium", read(props.class))}"
232
+ >${slot(props.children)}</div>`,
233
+ );
234
+
235
+ export const PopoverDescription = component<PopoverSectionProps>(
236
+ (props) => html`<p
237
+ data-slot="popover-description"
238
+ class="${() => cn("text-muted-foreground", read(props.class))}"
239
+ >${slot(props.children)}</p>`,
240
+ );
241
+
242
+ function renderContent(
243
+ registered: RegisteredContent,
244
+ contentId: string,
245
+ triggerId: string,
246
+ ): TemplateResult {
247
+ return html`<div
248
+ data-slot="popover-content"
249
+ id="${contentId}"
250
+ role="dialog"
251
+ aria-labelledby="${triggerId}"
252
+ tabindex="-1"
253
+ class="${cn(
254
+ popoverContentClasses,
255
+ zoomInOut,
256
+ slideInFromSide,
257
+ read(registered.class),
258
+ )}"
259
+ >${registered.render()}</div>`;
260
+ }
@@ -33,7 +33,7 @@ import type { Child } from "../lib/children.js";
33
33
  import { cn } from "../lib/cn.js";
34
34
  import { uid } from "../lib/id.js";
35
35
  import { type Reactive, read } from "../lib/props.js";
36
- import { RadioGroup } from "../molecules/RadioGroup.js";
36
+ import { RadioGroup, RadioGroupItem } from "../molecules/RadioGroup.js";
37
37
 
38
38
  export interface QuestionOption {
39
39
  value: string;
@@ -270,13 +270,16 @@ export const Questionnaire = component<QuestionnaireProps>((props) => {
270
270
  if (isSingle(question)) {
271
271
  return RadioGroup({
272
272
  name: question.id,
273
- options: question.options.map((option) => ({
274
- value: option.value,
275
- label: option.label,
276
- description: option.description,
277
- })),
278
273
  value: () => asValue(answerOf(question)),
279
274
  onValueChange: (value) => record(question, value),
275
+ children: () =>
276
+ question.options.map((option) =>
277
+ RadioGroupItem({
278
+ value: option.value,
279
+ children: option.label,
280
+ description: option.description,
281
+ }),
282
+ ),
280
283
  });
281
284
  }
282
285