@hydrateless/svelte 0.8.0 → 0.9.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 (155) hide show
  1. package/README.md +173 -38
  2. package/dist/components/Accordion.svelte +28 -17
  3. package/dist/components/Accordion.svelte.d.ts +3 -0
  4. package/dist/components/AccordionItem.svelte +17 -11
  5. package/dist/components/AccordionItem.svelte.d.ts +5 -3
  6. package/dist/components/Alert.svelte +4 -0
  7. package/dist/components/Alert.svelte.d.ts +4 -0
  8. package/dist/components/Avatar.svelte +5 -0
  9. package/dist/components/Avatar.svelte.d.ts +5 -0
  10. package/dist/components/AvatarGroup.svelte +1 -0
  11. package/dist/components/AvatarGroup.svelte.d.ts +1 -0
  12. package/dist/components/Badge.svelte +4 -0
  13. package/dist/components/Badge.svelte.d.ts +4 -0
  14. package/dist/components/Breadcrumb.svelte +1 -0
  15. package/dist/components/Breadcrumb.svelte.d.ts +1 -0
  16. package/dist/components/BreadcrumbItem.svelte +3 -0
  17. package/dist/components/BreadcrumbItem.svelte.d.ts +3 -0
  18. package/dist/components/Button.svelte +7 -0
  19. package/dist/components/Button.svelte.d.ts +7 -0
  20. package/dist/components/Card.svelte +2 -0
  21. package/dist/components/Card.svelte.d.ts +2 -0
  22. package/dist/components/CardBody.svelte +1 -0
  23. package/dist/components/CardBody.svelte.d.ts +1 -0
  24. package/dist/components/CardDescription.svelte +1 -0
  25. package/dist/components/CardDescription.svelte.d.ts +1 -0
  26. package/dist/components/CardFooter.svelte +1 -0
  27. package/dist/components/CardFooter.svelte.d.ts +1 -0
  28. package/dist/components/CardHeader.svelte +1 -0
  29. package/dist/components/CardHeader.svelte.d.ts +1 -0
  30. package/dist/components/CardTitle.svelte +1 -0
  31. package/dist/components/CardTitle.svelte.d.ts +1 -0
  32. package/dist/components/Checkbox.svelte +24 -2
  33. package/dist/components/Checkbox.svelte.d.ts +2 -0
  34. package/dist/components/Combobox.svelte +37 -26
  35. package/dist/components/Combobox.svelte.d.ts +12 -3
  36. package/dist/components/ComboboxInput.svelte +21 -2
  37. package/dist/components/ComboboxInput.svelte.d.ts +1 -0
  38. package/dist/components/ComboboxList.svelte +4 -1
  39. package/dist/components/ComboboxList.svelte.d.ts +1 -0
  40. package/dist/components/ComboboxOption.svelte +6 -2
  41. package/dist/components/ComboboxOption.svelte.d.ts +4 -0
  42. package/dist/components/Command.svelte +36 -9
  43. package/dist/components/Command.svelte.d.ts +12 -5
  44. package/dist/components/CommandEmpty.svelte +1 -0
  45. package/dist/components/CommandEmpty.svelte.d.ts +1 -0
  46. package/dist/components/CommandGroup.svelte +1 -0
  47. package/dist/components/CommandGroup.svelte.d.ts +1 -0
  48. package/dist/components/CommandItem.svelte +2 -0
  49. package/dist/components/CommandItem.svelte.d.ts +2 -0
  50. package/dist/components/CommandList.svelte +1 -0
  51. package/dist/components/CommandList.svelte.d.ts +1 -0
  52. package/dist/components/Disclosure.svelte +29 -19
  53. package/dist/components/Disclosure.svelte.d.ts +6 -1
  54. package/dist/components/Drawer.svelte +26 -20
  55. package/dist/components/Drawer.svelte.d.ts +6 -1
  56. package/dist/components/DrawerBody.svelte +1 -0
  57. package/dist/components/DrawerBody.svelte.d.ts +1 -0
  58. package/dist/components/DrawerFooter.svelte +1 -0
  59. package/dist/components/DrawerFooter.svelte.d.ts +1 -0
  60. package/dist/components/DrawerHeader.svelte +1 -0
  61. package/dist/components/DrawerHeader.svelte.d.ts +1 -0
  62. package/dist/components/Dropdown.svelte +45 -24
  63. package/dist/components/Dropdown.svelte.d.ts +13 -2
  64. package/dist/components/DropdownGroup.svelte +19 -0
  65. package/dist/components/DropdownGroup.svelte.d.ts +11 -0
  66. package/dist/components/DropdownItem.svelte +28 -4
  67. package/dist/components/DropdownItem.svelte.d.ts +11 -2
  68. package/dist/components/DropdownMenu.svelte +14 -2
  69. package/dist/components/DropdownMenu.svelte.d.ts +1 -0
  70. package/dist/components/DropdownSeparator.svelte +3 -2
  71. package/dist/components/DropdownTrigger.svelte +14 -2
  72. package/dist/components/DropdownTrigger.svelte.d.ts +1 -0
  73. package/dist/components/Field.svelte +42 -3
  74. package/dist/components/Field.svelte.d.ts +16 -0
  75. package/dist/components/FieldError.svelte +4 -3
  76. package/dist/components/FieldError.svelte.d.ts +1 -0
  77. package/dist/components/FieldHelp.svelte +4 -3
  78. package/dist/components/FieldHelp.svelte.d.ts +1 -0
  79. package/dist/components/FieldLabel.svelte +4 -3
  80. package/dist/components/FieldLabel.svelte.d.ts +1 -0
  81. package/dist/components/Fieldset.svelte +2 -0
  82. package/dist/components/Fieldset.svelte.d.ts +2 -0
  83. package/dist/components/Input.svelte +22 -6
  84. package/dist/components/Input.svelte.d.ts +3 -0
  85. package/dist/components/Kbd.svelte +1 -0
  86. package/dist/components/Kbd.svelte.d.ts +1 -0
  87. package/dist/components/Menu.svelte +36 -23
  88. package/dist/components/Menu.svelte.d.ts +18 -5
  89. package/dist/components/MenuItem.svelte +46 -18
  90. package/dist/components/MenuItem.svelte.d.ts +10 -7
  91. package/dist/components/MenuSubmenu.svelte +30 -0
  92. package/dist/components/MenuSubmenu.svelte.d.ts +17 -0
  93. package/dist/components/Modal.svelte +17 -18
  94. package/dist/components/Modal.svelte.d.ts +4 -0
  95. package/dist/components/ModalBody.svelte +1 -0
  96. package/dist/components/ModalBody.svelte.d.ts +1 -0
  97. package/dist/components/ModalFooter.svelte +1 -0
  98. package/dist/components/ModalFooter.svelte.d.ts +1 -0
  99. package/dist/components/ModalHeader.svelte +1 -0
  100. package/dist/components/ModalHeader.svelte.d.ts +1 -0
  101. package/dist/components/Pagination.svelte +5 -0
  102. package/dist/components/Pagination.svelte.d.ts +5 -0
  103. package/dist/components/Popover.svelte +37 -20
  104. package/dist/components/Popover.svelte.d.ts +12 -2
  105. package/dist/components/Progress.svelte +4 -0
  106. package/dist/components/Progress.svelte.d.ts +4 -0
  107. package/dist/components/Radio.svelte +2 -0
  108. package/dist/components/Radio.svelte.d.ts +2 -0
  109. package/dist/components/RadioGroup.svelte +34 -4
  110. package/dist/components/RadioGroup.svelte.d.ts +10 -1
  111. package/dist/components/SegmentedControl.svelte +25 -10
  112. package/dist/components/SegmentedControl.svelte.d.ts +11 -3
  113. package/dist/components/Select.svelte +16 -5
  114. package/dist/components/Select.svelte.d.ts +4 -0
  115. package/dist/components/Separator.svelte +2 -0
  116. package/dist/components/Separator.svelte.d.ts +2 -0
  117. package/dist/components/Skeleton.svelte +6 -3
  118. package/dist/components/Skeleton.svelte.d.ts +4 -1
  119. package/dist/components/SkipLink.svelte +1 -0
  120. package/dist/components/SkipLink.svelte.d.ts +1 -0
  121. package/dist/components/Slider.svelte +23 -2
  122. package/dist/components/Slider.svelte.d.ts +1 -0
  123. package/dist/components/Spinner.svelte +2 -0
  124. package/dist/components/Spinner.svelte.d.ts +2 -0
  125. package/dist/components/Switch.svelte +25 -2
  126. package/dist/components/Switch.svelte.d.ts +2 -0
  127. package/dist/components/Tab.svelte +16 -2
  128. package/dist/components/Tab.svelte.d.ts +1 -0
  129. package/dist/components/TabList.svelte +1 -0
  130. package/dist/components/TabList.svelte.d.ts +1 -0
  131. package/dist/components/TabPanel.svelte +8 -1
  132. package/dist/components/TabPanel.svelte.d.ts +1 -0
  133. package/dist/components/Table.svelte +30 -0
  134. package/dist/components/Table.svelte.d.ts +17 -0
  135. package/dist/components/Tabs.svelte +41 -19
  136. package/dist/components/Tabs.svelte.d.ts +6 -1
  137. package/dist/components/Textarea.svelte +26 -6
  138. package/dist/components/Textarea.svelte.d.ts +5 -0
  139. package/dist/components/ToastRegion.svelte +18 -2
  140. package/dist/components/ToastRegion.svelte.d.ts +8 -1
  141. package/dist/components/Toc.svelte +19 -8
  142. package/dist/components/Toc.svelte.d.ts +6 -0
  143. package/dist/components/Tooltip.svelte +57 -19
  144. package/dist/components/Tooltip.svelte.d.ts +16 -7
  145. package/dist/context.d.ts +84 -8
  146. package/dist/context.js +60 -11
  147. package/dist/index.d.ts +8 -4
  148. package/dist/index.js +6 -4
  149. package/dist/toast.d.ts +12 -7
  150. package/dist/toast.js +20 -11
  151. package/dist/useEnhancer.svelte.d.ts +40 -0
  152. package/dist/useEnhancer.svelte.js +58 -0
  153. package/package.json +4 -4
  154. package/dist/actions.d.ts +0 -25
  155. package/dist/actions.js +0 -31
@@ -1,23 +1,30 @@
1
1
  <script lang="ts">
2
- import { enhanceDrawer, type DrawerApi } from '@hydrateless/enhancers';
2
+ import { enhanceDrawer } from '@hydrateless/enhancers';
3
3
  import { untrack } from 'svelte';
4
4
  import type { Snippet } from 'svelte';
5
5
  import type { HTMLDialogAttributes } from 'svelte/elements';
6
+ import { useEnhancer } from '../useEnhancer.svelte.js';
6
7
 
7
8
  interface Props extends HTMLDialogAttributes {
8
9
  /** Open state; two-way bindable (`bind:open`). */
9
10
  open?: boolean;
10
11
  /** Open the drawer initially for uncontrolled usage. */
11
12
  defaultOpen?: boolean;
12
- side?: 'left' | 'right';
13
+ /** Called after the drawer opens or closes (including native Escape). */
14
+ onOpenChange?: (open: boolean) => void;
15
+ /** Logical edge the drawer slides in from (RTL-aware). Defaults to `end`. */
16
+ side?: 'start' | 'end';
17
+ /** Let Escape and a backdrop click close the drawer. Defaults to `true`. */
13
18
  closeOnBackdrop?: boolean;
19
+ /** Drawer content; compose with `<DrawerHeader>`, `<DrawerBody>`, `<DrawerFooter>`. */
14
20
  children?: Snippet;
15
21
  }
16
22
 
17
23
  let {
18
24
  defaultOpen = false,
19
25
  open = $bindable(),
20
- side = 'right',
26
+ onOpenChange,
27
+ side = 'end',
21
28
  closeOnBackdrop = true,
22
29
  class: klass,
23
30
  children,
@@ -25,28 +32,27 @@
25
32
  }: Props = $props();
26
33
  // svelte-ignore state_referenced_locally -- seeds the uncontrolled initial value once
27
34
  if (open === undefined) open = defaultOpen;
28
- let dialog = $state<HTMLDialogElement>();
29
- let api = $state<DrawerApi | null>(null);
30
35
 
31
- $effect(() => {
32
- if (!dialog) return;
33
- const handle = enhanceDrawer(dialog, {
34
- closeOnBackdrop,
35
- defaultOpen: untrack(() => open),
36
- onOpenChange: (next) => (open = next),
37
- });
38
- api = handle.api;
39
- return () => {
40
- handle.destroy();
41
- api = null;
42
- };
43
- });
36
+ const drawer = useEnhancer(enhanceDrawer, () => ({
37
+ closeOnBackdrop,
38
+ defaultOpen: untrack(() => open),
39
+ onOpenChange: (next) => {
40
+ open = next;
41
+ onOpenChange?.(next);
42
+ },
43
+ }));
44
44
 
45
45
  $effect(() => {
46
- if (open != null) api?.setOpen(open);
46
+ if (open != null) drawer.api?.setOpen(open);
47
47
  });
48
48
  </script>
49
49
 
50
- <dialog {...rest} bind:this={dialog} data-side={side} class={['hl-drawer', klass]} data-hl-drawer>
50
+ <dialog
51
+ {...rest}
52
+ class={['hl-drawer', klass]}
53
+ data-hl-drawer
54
+ data-hl-side={side}
55
+ {@attach drawer.attach}
56
+ >
51
57
  {@render children?.()}
52
58
  </dialog>
@@ -5,8 +5,13 @@ interface Props extends HTMLDialogAttributes {
5
5
  open?: boolean;
6
6
  /** Open the drawer initially for uncontrolled usage. */
7
7
  defaultOpen?: boolean;
8
- side?: 'left' | 'right';
8
+ /** Called after the drawer opens or closes (including native Escape). */
9
+ onOpenChange?: (open: boolean) => void;
10
+ /** Logical edge the drawer slides in from (RTL-aware). Defaults to `end`. */
11
+ side?: 'start' | 'end';
12
+ /** Let Escape and a backdrop click close the drawer. Defaults to `true`. */
9
13
  closeOnBackdrop?: boolean;
14
+ /** Drawer content; compose with `<DrawerHeader>`, `<DrawerBody>`, `<DrawerFooter>`. */
10
15
  children?: Snippet;
11
16
  }
12
17
  declare const Drawer: import("svelte").Component<Props, {}, "open">;
@@ -3,6 +3,7 @@
3
3
  import type { HTMLAttributes } from 'svelte/elements';
4
4
 
5
5
  interface Props extends HTMLAttributes<HTMLDivElement> {
6
+ /** Main drawer content. */
6
7
  children?: Snippet;
7
8
  }
8
9
 
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLDivElement> {
4
+ /** Main drawer content. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const DrawerBody: import("svelte").Component<Props, {}, "">;
@@ -3,6 +3,7 @@
3
3
  import type { HTMLAttributes } from 'svelte/elements';
4
4
 
5
5
  interface Props extends HTMLAttributes<HTMLDivElement> {
6
+ /** Footer content, typically actions. */
6
7
  children?: Snippet;
7
8
  }
8
9
 
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLDivElement> {
4
+ /** Footer content, typically actions. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const DrawerFooter: import("svelte").Component<Props, {}, "">;
@@ -3,6 +3,7 @@
3
3
  import type { HTMLAttributes } from 'svelte/elements';
4
4
 
5
5
  interface Props extends HTMLAttributes<HTMLDivElement> {
6
+ /** Drawer title; the enhancer labels the drawer with this section. */
6
7
  children?: Snippet;
7
8
  }
8
9
 
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLDivElement> {
4
+ /** Drawer title; the enhancer labels the drawer with this section. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const DrawerHeader: import("svelte").Component<Props, {}, "">;
@@ -1,47 +1,68 @@
1
1
  <script lang="ts">
2
- import {
3
- enhanceDropdown,
4
- type DropdownApi,
5
- type EnhanceDropdownOptions,
6
- } from '@hydrateless/enhancers';
2
+ import { enhanceDropdown, type EnhanceDropdownOptions } from '@hydrateless/enhancers';
7
3
  import { untrack } from 'svelte';
8
4
  import type { Snippet } from 'svelte';
9
5
  import type { HTMLAttributes } from 'svelte/elements';
6
+ import { setDropdownContext } from '../context.js';
7
+ import { useEnhancer } from '../useEnhancer.svelte.js';
10
8
 
11
- interface Props extends HTMLAttributes<HTMLDivElement> {
12
- placement?: EnhanceDropdownOptions['placement'];
9
+ interface Props extends Omit<HTMLAttributes<HTMLDivElement>, 'onselect'> {
13
10
  /** Open state; two-way bindable (`bind:open`). */
14
11
  open?: boolean;
15
12
  /** Open the menu initially for uncontrolled usage. */
16
13
  defaultOpen?: boolean;
14
+ /** Called after the menu opens or closes. */
15
+ onOpenChange?: (open: boolean) => void;
16
+ /**
17
+ * Called with the item's value when a menu item is activated. For
18
+ * `menuitemcheckbox`/`menuitemradio` items, `checked` is the new state.
19
+ */
20
+ onSelect?: (value: string, item: HTMLElement, checked?: boolean) => void;
21
+ /** Close the menu after an item is activated. Defaults to `true`. */
22
+ closeOnSelect?: boolean;
23
+ /** Placement of the menu relative to the trigger. Defaults to `bottom-start`. */
24
+ placement?: EnhanceDropdownOptions['placement'];
25
+ /** A `<DropdownTrigger>` followed by a `<DropdownMenu>`. */
17
26
  children?: Snippet;
18
27
  }
19
28
 
20
- let { placement, defaultOpen = false, open = $bindable(), children, ...rest }: Props = $props();
29
+ let {
30
+ open = $bindable(),
31
+ defaultOpen = false,
32
+ onOpenChange,
33
+ onSelect,
34
+ closeOnSelect = true,
35
+ placement,
36
+ children,
37
+ ...rest
38
+ }: Props = $props();
21
39
  // svelte-ignore state_referenced_locally -- seeds the uncontrolled initial value once
22
40
  if (open === undefined) open = defaultOpen;
23
- let host = $state<HTMLDivElement>();
24
- let api = $state<DropdownApi | null>(null);
25
41
 
26
- $effect(() => {
27
- if (!host) return;
28
- const handle = enhanceDropdown(host, {
29
- placement,
30
- defaultOpen: untrack(() => open),
31
- onOpenChange: (next) => (open = next),
32
- });
33
- api = handle.api;
34
- return () => {
35
- handle.destroy();
36
- api = null;
37
- };
42
+ // The trigger's `popovertarget` must name the menu in server-rendered
43
+ // markup so the menu opens before (or without) JavaScript.
44
+ const generatedId = $props.id();
45
+ setDropdownContext({
46
+ menuId: `hl-dropdown-menu-${generatedId}`,
47
+ triggerId: `hl-dropdown-trigger-${generatedId}`,
38
48
  });
39
49
 
50
+ const dropdown = useEnhancer(enhanceDropdown, () => ({
51
+ placement,
52
+ closeOnSelect,
53
+ defaultOpen: untrack(() => open),
54
+ onOpenChange: (next) => {
55
+ open = next;
56
+ onOpenChange?.(next);
57
+ },
58
+ onSelect: (value, item, checked) => onSelect?.(value, item, checked),
59
+ }));
60
+
40
61
  $effect(() => {
41
- if (open != null) api?.setOpen(open);
62
+ if (open != null) dropdown.api?.setOpen(open);
42
63
  });
43
64
  </script>
44
65
 
45
- <div {...rest} data-hl-dropdown bind:this={host}>
66
+ <div {...rest} data-hl-dropdown {@attach dropdown.attach}>
46
67
  {@render children?.()}
47
68
  </div>
@@ -1,12 +1,23 @@
1
1
  import { type EnhanceDropdownOptions } from '@hydrateless/enhancers';
2
2
  import type { Snippet } from 'svelte';
3
3
  import type { HTMLAttributes } from 'svelte/elements';
4
- interface Props extends HTMLAttributes<HTMLDivElement> {
5
- placement?: EnhanceDropdownOptions['placement'];
4
+ interface Props extends Omit<HTMLAttributes<HTMLDivElement>, 'onselect'> {
6
5
  /** Open state; two-way bindable (`bind:open`). */
7
6
  open?: boolean;
8
7
  /** Open the menu initially for uncontrolled usage. */
9
8
  defaultOpen?: boolean;
9
+ /** Called after the menu opens or closes. */
10
+ onOpenChange?: (open: boolean) => void;
11
+ /**
12
+ * Called with the item's value when a menu item is activated. For
13
+ * `menuitemcheckbox`/`menuitemradio` items, `checked` is the new state.
14
+ */
15
+ onSelect?: (value: string, item: HTMLElement, checked?: boolean) => void;
16
+ /** Close the menu after an item is activated. Defaults to `true`. */
17
+ closeOnSelect?: boolean;
18
+ /** Placement of the menu relative to the trigger. Defaults to `bottom-start`. */
19
+ placement?: EnhanceDropdownOptions['placement'];
20
+ /** A `<DropdownTrigger>` followed by a `<DropdownMenu>`. */
10
21
  children?: Snippet;
11
22
  }
12
23
  declare const Dropdown: import("svelte").Component<Props, {}, "open">;
@@ -0,0 +1,19 @@
1
+ <script lang="ts">
2
+ import type { Snippet } from 'svelte';
3
+ import type { HTMLAttributes } from 'svelte/elements';
4
+
5
+ interface Props extends HTMLAttributes<HTMLUListElement> {
6
+ /** Accessible name of the group, rendered as `aria-label`. */
7
+ label?: string;
8
+ /** `<DropdownItem>`s; `menuitemradio` items are exclusive within the group. */
9
+ children?: Snippet;
10
+ }
11
+
12
+ let { label, class: klass, children, ...rest }: Props = $props();
13
+ </script>
14
+
15
+ <li>
16
+ <ul {...rest} role="group" aria-label={label} class={['hl-dropdown-group', klass]}>
17
+ {@render children?.()}
18
+ </ul>
19
+ </li>
@@ -0,0 +1,11 @@
1
+ import type { Snippet } from 'svelte';
2
+ import type { HTMLAttributes } from 'svelte/elements';
3
+ interface Props extends HTMLAttributes<HTMLUListElement> {
4
+ /** Accessible name of the group, rendered as `aria-label`. */
5
+ label?: string;
6
+ /** `<DropdownItem>`s; `menuitemradio` items are exclusive within the group. */
7
+ children?: Snippet;
8
+ }
9
+ declare const DropdownGroup: import("svelte").Component<Props, {}, "">;
10
+ type DropdownGroup = ReturnType<typeof DropdownGroup>;
11
+ export default DropdownGroup;
@@ -2,21 +2,45 @@
2
2
  import type { Snippet } from 'svelte';
3
3
  import type { HTMLButtonAttributes } from 'svelte/elements';
4
4
 
5
- interface Props extends HTMLButtonAttributes {
6
- /** Convenience handler fired on click; you can also pass `onclick`. */
5
+ interface Props extends Omit<HTMLButtonAttributes, 'role' | 'value'> {
6
+ /** Value reported to `onSelect`; defaults to the item's text. */
7
+ value?: string;
8
+ /** Skip the item in keyboard navigation and ignore activation. */
9
+ disabled?: boolean;
10
+ /** `menuitemcheckbox` toggles; `menuitemradio` is exclusive within its `<DropdownGroup>`. */
11
+ role?: 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';
12
+ /** Checked state for checkable roles; rendered as `aria-checked`. */
13
+ checked?: boolean;
14
+ /** Convenience handler fired on activation; the Dropdown's `onSelect` also fires. */
7
15
  onSelect?: () => void;
16
+ /** Item label. */
8
17
  children?: Snippet;
9
18
  }
10
19
 
11
- let { onSelect, onclick, type, children, ...rest }: Props = $props();
20
+ let {
21
+ value,
22
+ disabled,
23
+ role = 'menuitem',
24
+ checked,
25
+ onSelect,
26
+ onclick,
27
+ type,
28
+ children,
29
+ ...rest
30
+ }: Props = $props();
31
+ const checkable = $derived(role !== 'menuitem');
12
32
  </script>
13
33
 
14
34
  <li>
15
35
  <button
16
36
  {...rest}
17
37
  type={type ?? 'button'}
18
- role="menuitem"
38
+ {role}
39
+ data-hl-value={value}
40
+ disabled={disabled || undefined}
41
+ aria-checked={checkable ? (checked ?? false) : undefined}
19
42
  onclick={(e) => {
43
+ if (disabled) return;
20
44
  onSelect?.();
21
45
  onclick?.(e);
22
46
  }}
@@ -1,8 +1,17 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLButtonAttributes } from 'svelte/elements';
3
- interface Props extends HTMLButtonAttributes {
4
- /** Convenience handler fired on click; you can also pass `onclick`. */
3
+ interface Props extends Omit<HTMLButtonAttributes, 'role' | 'value'> {
4
+ /** Value reported to `onSelect`; defaults to the item's text. */
5
+ value?: string;
6
+ /** Skip the item in keyboard navigation and ignore activation. */
7
+ disabled?: boolean;
8
+ /** `menuitemcheckbox` toggles; `menuitemradio` is exclusive within its `<DropdownGroup>`. */
9
+ role?: 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';
10
+ /** Checked state for checkable roles; rendered as `aria-checked`. */
11
+ checked?: boolean;
12
+ /** Convenience handler fired on activation; the Dropdown's `onSelect` also fires. */
5
13
  onSelect?: () => void;
14
+ /** Item label. */
6
15
  children?: Snippet;
7
16
  }
8
17
  declare const DropdownItem: import("svelte").Component<Props, {}, "">;
@@ -1,14 +1,26 @@
1
1
  <script lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
3
  import type { HTMLAttributes } from 'svelte/elements';
4
+ import { getDropdownContext } from '../context.js';
4
5
 
5
6
  interface Props extends HTMLAttributes<HTMLUListElement> {
7
+ /** `<DropdownItem>`s, `<DropdownGroup>`s, and `<DropdownSeparator>`s. */
6
8
  children?: Snippet;
7
9
  }
8
10
 
9
- let { children, ...rest }: Props = $props();
11
+ let { id, children, ...rest }: Props = $props();
12
+ const dropdown = getDropdownContext();
10
13
  </script>
11
14
 
12
- <ul {...rest} data-hl-dropdown-menu>
15
+ <!-- `popover` is in the markup (not added by the enhancer) so the trigger's
16
+ `popovertarget` opens the menu before hydration. -->
17
+ <ul
18
+ {...rest}
19
+ id={id ?? dropdown?.menuId}
20
+ data-hl-dropdown-menu
21
+ popover="auto"
22
+ role="menu"
23
+ aria-labelledby={dropdown?.triggerId}
24
+ >
13
25
  {@render children?.()}
14
26
  </ul>
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLUListElement> {
4
+ /** `<DropdownItem>`s, `<DropdownGroup>`s, and `<DropdownSeparator>`s. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const DropdownMenu: import("svelte").Component<Props, {}, "">;
@@ -1,7 +1,8 @@
1
1
  <script lang="ts">
2
2
  import type { HTMLLiAttributes } from 'svelte/elements';
3
3
 
4
- let { ...rest }: Omit<HTMLLiAttributes, 'role'> = $props();
4
+ /** Visual divider between groups of menu items. */
5
+ let { class: klass, ...rest }: Omit<HTMLLiAttributes, 'role'> = $props();
5
6
  </script>
6
7
 
7
- <li {...rest} role="separator"></li>
8
+ <li {...rest} role="separator" class={['hl-dropdown-separator', klass]}></li>
@@ -1,14 +1,26 @@
1
1
  <script lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
3
  import type { HTMLButtonAttributes } from 'svelte/elements';
4
+ import { getDropdownContext } from '../context.js';
4
5
 
5
6
  interface Props extends HTMLButtonAttributes {
7
+ /** Trigger label. */
6
8
  children?: Snippet;
7
9
  }
8
10
 
9
- let { type, children, ...rest }: Props = $props();
11
+ let { type, id, children, ...rest }: Props = $props();
12
+ const dropdown = getDropdownContext();
10
13
  </script>
11
14
 
12
- <button {...rest} type={type ?? 'button'} data-hl-dropdown-trigger>
15
+ <button
16
+ {...rest}
17
+ id={id ?? dropdown?.triggerId}
18
+ type={type ?? 'button'}
19
+ data-hl-dropdown-trigger
20
+ popovertarget={dropdown?.menuId}
21
+ aria-haspopup="menu"
22
+ aria-expanded="false"
23
+ aria-controls={dropdown?.menuId}
24
+ >
13
25
  {@render children?.()}
14
26
  </button>
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLButtonAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLButtonAttributes {
4
+ /** Trigger label. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const DropdownTrigger: import("svelte").Component<Props, {}, "">;
@@ -2,18 +2,49 @@
2
2
  import type { Snippet } from 'svelte';
3
3
  import type { HTMLAttributes } from 'svelte/elements';
4
4
  import { setFieldContext } from '../context.js';
5
+ import FieldLabel from './FieldLabel.svelte';
6
+ import FieldHelp from './FieldHelp.svelte';
7
+ import FieldError from './FieldError.svelte';
5
8
 
6
9
  interface Props extends HTMLAttributes<HTMLDivElement> {
10
+ /**
11
+ * Id given to the control inside the Field (the label's `for` target).
12
+ * Generated when omitted. Help and error text derive their ids from it.
13
+ */
7
14
  id?: string;
15
+ /** Label text; renders a `<FieldLabel>` before the control. */
16
+ label?: string;
17
+ /** Help text; renders a `<FieldHelp>` after the control. */
18
+ description?: string;
19
+ /** Validation message; renders a `<FieldError>` and marks the field invalid. */
20
+ error?: string;
21
+ /** Mark the field invalid: sets `aria-invalid` on the control and reveals `<FieldError>`. */
8
22
  invalid?: boolean;
23
+ /** Mark the field required: sets `required` on the control and flags the label. */
9
24
  required?: boolean;
25
+ /**
26
+ * The control, plus any `<FieldLabel>`/`<FieldHelp>`/`<FieldError>` you
27
+ * compose yourself instead of using the shorthand props.
28
+ */
10
29
  children?: Snippet;
11
30
  }
12
31
 
13
- let { id, invalid = false, required = false, class: klass, children, ...rest }: Props = $props();
32
+ let {
33
+ id,
34
+ label,
35
+ description,
36
+ error,
37
+ invalid = false,
38
+ required = false,
39
+ class: klass,
40
+ children,
41
+ ...rest
42
+ }: Props = $props();
14
43
  // SSR-safe: $props.id() is stable across server and client renders.
15
44
  const generatedId = $props.id();
16
45
  const baseId = $derived(id ?? `hl-field-${generatedId}`);
46
+ const hasError = $derived(error != null && error !== '');
47
+ const isInvalid = $derived(invalid || hasError);
17
48
 
18
49
  setFieldContext({
19
50
  get id() {
@@ -26,7 +57,7 @@
26
57
  return `${baseId}-error`;
27
58
  },
28
59
  get invalid() {
29
- return invalid;
60
+ return isInvalid;
30
61
  },
31
62
  get required() {
32
63
  return required;
@@ -34,6 +65,14 @@
34
65
  });
35
66
  </script>
36
67
 
37
- <div {...rest} class={['hl-field', klass]} data-hl-invalid={invalid || undefined}>
68
+ <div
69
+ {...rest}
70
+ class={['hl-field', klass]}
71
+ data-hl-invalid={isInvalid || undefined}
72
+ data-hl-required={required || undefined}
73
+ >
74
+ {#if label != null}<FieldLabel>{label}</FieldLabel>{/if}
38
75
  {@render children?.()}
76
+ {#if description != null}<FieldHelp>{description}</FieldHelp>{/if}
77
+ {#if hasError}<FieldError>{error}</FieldError>{/if}
39
78
  </div>
@@ -1,9 +1,25 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLDivElement> {
4
+ /**
5
+ * Id given to the control inside the Field (the label's `for` target).
6
+ * Generated when omitted. Help and error text derive their ids from it.
7
+ */
4
8
  id?: string;
9
+ /** Label text; renders a `<FieldLabel>` before the control. */
10
+ label?: string;
11
+ /** Help text; renders a `<FieldHelp>` after the control. */
12
+ description?: string;
13
+ /** Validation message; renders a `<FieldError>` and marks the field invalid. */
14
+ error?: string;
15
+ /** Mark the field invalid: sets `aria-invalid` on the control and reveals `<FieldError>`. */
5
16
  invalid?: boolean;
17
+ /** Mark the field required: sets `required` on the control and flags the label. */
6
18
  required?: boolean;
19
+ /**
20
+ * The control, plus any `<FieldLabel>`/`<FieldHelp>`/`<FieldError>` you
21
+ * compose yourself instead of using the shorthand props.
22
+ */
7
23
  children?: Snippet;
8
24
  }
9
25
  declare const Field: import("svelte").Component<Props, {}, "">;
@@ -4,15 +4,16 @@
4
4
  import { getFieldContext } from '../context.js';
5
5
 
6
6
  interface Props extends HTMLAttributes<HTMLParagraphElement> {
7
+ /** Validation message; nothing renders without content. */
7
8
  children?: Snippet;
8
9
  }
9
10
 
10
- let { class: klass, children, ...rest }: Props = $props();
11
- const ctx = getFieldContext();
11
+ let { id, class: klass, children, ...rest }: Props = $props();
12
+ const field = getFieldContext();
12
13
  </script>
13
14
 
14
15
  {#if children}
15
- <p {...rest} id={ctx?.errorId} role="alert" class={['hl-error', klass]}>
16
+ <p {...rest} id={id ?? field?.errorId} role="alert" class={['hl-error', klass]}>
16
17
  {@render children()}
17
18
  </p>
18
19
  {/if}
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLParagraphElement> {
4
+ /** Validation message; nothing renders without content. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const FieldError: import("svelte").Component<Props, {}, "">;
@@ -4,13 +4,14 @@
4
4
  import { getFieldContext } from '../context.js';
5
5
 
6
6
  interface Props extends HTMLAttributes<HTMLParagraphElement> {
7
+ /** Supplementary help text, referenced by the control's `aria-describedby`. */
7
8
  children?: Snippet;
8
9
  }
9
10
 
10
- let { class: klass, children, ...rest }: Props = $props();
11
- const ctx = getFieldContext();
11
+ let { id, class: klass, children, ...rest }: Props = $props();
12
+ const field = getFieldContext();
12
13
  </script>
13
14
 
14
- <p {...rest} id={ctx?.helpId} class={['hl-help', klass]}>
15
+ <p {...rest} id={id ?? field?.helpId} class={['hl-help', klass]}>
15
16
  {@render children?.()}
16
17
  </p>
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLAttributes<HTMLParagraphElement> {
4
+ /** Supplementary help text, referenced by the control's `aria-describedby`. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const FieldHelp: import("svelte").Component<Props, {}, "">;
@@ -4,18 +4,19 @@
4
4
  import { getFieldContext } from '../context.js';
5
5
 
6
6
  interface Props extends HTMLLabelAttributes {
7
+ /** Label text. */
7
8
  children?: Snippet;
8
9
  }
9
10
 
10
11
  let { for: htmlFor, class: klass, children, ...rest }: Props = $props();
11
- const ctx = getFieldContext();
12
+ const field = getFieldContext();
12
13
  </script>
13
14
 
14
15
  <label
15
16
  {...rest}
16
- for={htmlFor ?? ctx?.id}
17
+ for={htmlFor ?? field?.id}
17
18
  class={['hl-label', klass]}
18
- data-hl-required={ctx?.required || undefined}
19
+ data-hl-required={field?.required || undefined}
19
20
  >
20
21
  {@render children?.()}
21
22
  </label>
@@ -1,6 +1,7 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLLabelAttributes } from 'svelte/elements';
3
3
  interface Props extends HTMLLabelAttributes {
4
+ /** Label text. */
4
5
  children?: Snippet;
5
6
  }
6
7
  declare const FieldLabel: import("svelte").Component<Props, {}, "">;