@hydrateless/svelte 0.7.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.
- package/README.md +173 -38
- package/dist/components/Accordion.svelte +28 -17
- package/dist/components/Accordion.svelte.d.ts +3 -0
- package/dist/components/AccordionItem.svelte +17 -11
- package/dist/components/AccordionItem.svelte.d.ts +5 -3
- package/dist/components/Alert.svelte +4 -0
- package/dist/components/Alert.svelte.d.ts +4 -0
- package/dist/components/Avatar.svelte +5 -0
- package/dist/components/Avatar.svelte.d.ts +5 -0
- package/dist/components/AvatarGroup.svelte +1 -0
- package/dist/components/AvatarGroup.svelte.d.ts +1 -0
- package/dist/components/Badge.svelte +4 -0
- package/dist/components/Badge.svelte.d.ts +4 -0
- package/dist/components/Breadcrumb.svelte +1 -0
- package/dist/components/Breadcrumb.svelte.d.ts +1 -0
- package/dist/components/BreadcrumbItem.svelte +3 -0
- package/dist/components/BreadcrumbItem.svelte.d.ts +3 -0
- package/dist/components/Button.svelte +7 -0
- package/dist/components/Button.svelte.d.ts +7 -0
- package/dist/components/Card.svelte +2 -0
- package/dist/components/Card.svelte.d.ts +2 -0
- package/dist/components/CardBody.svelte +1 -0
- package/dist/components/CardBody.svelte.d.ts +1 -0
- package/dist/components/CardDescription.svelte +1 -0
- package/dist/components/CardDescription.svelte.d.ts +1 -0
- package/dist/components/CardFooter.svelte +1 -0
- package/dist/components/CardFooter.svelte.d.ts +1 -0
- package/dist/components/CardHeader.svelte +1 -0
- package/dist/components/CardHeader.svelte.d.ts +1 -0
- package/dist/components/CardTitle.svelte +1 -0
- package/dist/components/CardTitle.svelte.d.ts +1 -0
- package/dist/components/Checkbox.svelte +24 -2
- package/dist/components/Checkbox.svelte.d.ts +2 -0
- package/dist/components/Combobox.svelte +37 -26
- package/dist/components/Combobox.svelte.d.ts +12 -3
- package/dist/components/ComboboxInput.svelte +21 -2
- package/dist/components/ComboboxInput.svelte.d.ts +1 -0
- package/dist/components/ComboboxList.svelte +4 -1
- package/dist/components/ComboboxList.svelte.d.ts +1 -0
- package/dist/components/ComboboxOption.svelte +6 -2
- package/dist/components/ComboboxOption.svelte.d.ts +4 -0
- package/dist/components/Command.svelte +36 -9
- package/dist/components/Command.svelte.d.ts +12 -5
- package/dist/components/CommandEmpty.svelte +1 -0
- package/dist/components/CommandEmpty.svelte.d.ts +1 -0
- package/dist/components/CommandGroup.svelte +1 -0
- package/dist/components/CommandGroup.svelte.d.ts +1 -0
- package/dist/components/CommandItem.svelte +2 -0
- package/dist/components/CommandItem.svelte.d.ts +2 -0
- package/dist/components/CommandList.svelte +1 -0
- package/dist/components/CommandList.svelte.d.ts +1 -0
- package/dist/components/Disclosure.svelte +50 -6
- package/dist/components/Disclosure.svelte.d.ts +15 -2
- package/dist/components/Drawer.svelte +32 -21
- package/dist/components/Drawer.svelte.d.ts +8 -1
- package/dist/components/DrawerBody.svelte +1 -0
- package/dist/components/DrawerBody.svelte.d.ts +1 -0
- package/dist/components/DrawerFooter.svelte +1 -0
- package/dist/components/DrawerFooter.svelte.d.ts +1 -0
- package/dist/components/DrawerHeader.svelte +1 -0
- package/dist/components/DrawerHeader.svelte.d.ts +1 -0
- package/dist/components/Dropdown.svelte +49 -24
- package/dist/components/Dropdown.svelte.d.ts +15 -2
- package/dist/components/DropdownGroup.svelte +19 -0
- package/dist/components/DropdownGroup.svelte.d.ts +11 -0
- package/dist/components/DropdownItem.svelte +28 -4
- package/dist/components/DropdownItem.svelte.d.ts +11 -2
- package/dist/components/DropdownMenu.svelte +14 -2
- package/dist/components/DropdownMenu.svelte.d.ts +1 -0
- package/dist/components/DropdownSeparator.svelte +3 -2
- package/dist/components/DropdownTrigger.svelte +14 -2
- package/dist/components/DropdownTrigger.svelte.d.ts +1 -0
- package/dist/components/Field.svelte +45 -5
- package/dist/components/Field.svelte.d.ts +16 -0
- package/dist/components/FieldError.svelte +4 -3
- package/dist/components/FieldError.svelte.d.ts +1 -0
- package/dist/components/FieldHelp.svelte +4 -3
- package/dist/components/FieldHelp.svelte.d.ts +1 -0
- package/dist/components/FieldLabel.svelte +4 -3
- package/dist/components/FieldLabel.svelte.d.ts +1 -0
- package/dist/components/Fieldset.svelte +2 -0
- package/dist/components/Fieldset.svelte.d.ts +2 -0
- package/dist/components/Input.svelte +22 -6
- package/dist/components/Input.svelte.d.ts +3 -0
- package/dist/components/Kbd.svelte +1 -0
- package/dist/components/Kbd.svelte.d.ts +1 -0
- package/dist/components/Menu.svelte +43 -6
- package/dist/components/Menu.svelte.d.ts +19 -2
- package/dist/components/MenuItem.svelte +49 -18
- package/dist/components/MenuItem.svelte.d.ts +12 -7
- package/dist/components/MenuSubmenu.svelte +30 -0
- package/dist/components/MenuSubmenu.svelte.d.ts +17 -0
- package/dist/components/Modal.svelte +23 -19
- package/dist/components/Modal.svelte.d.ts +6 -0
- package/dist/components/ModalBody.svelte +1 -0
- package/dist/components/ModalBody.svelte.d.ts +1 -0
- package/dist/components/ModalFooter.svelte +1 -0
- package/dist/components/ModalFooter.svelte.d.ts +1 -0
- package/dist/components/ModalHeader.svelte +1 -0
- package/dist/components/ModalHeader.svelte.d.ts +1 -0
- package/dist/components/Pagination.svelte +5 -0
- package/dist/components/Pagination.svelte.d.ts +5 -0
- package/dist/components/Popover.svelte +41 -18
- package/dist/components/Popover.svelte.d.ts +14 -2
- package/dist/components/Progress.svelte +4 -0
- package/dist/components/Progress.svelte.d.ts +4 -0
- package/dist/components/Radio.svelte +2 -0
- package/dist/components/Radio.svelte.d.ts +2 -0
- package/dist/components/RadioGroup.svelte +34 -4
- package/dist/components/RadioGroup.svelte.d.ts +10 -1
- package/dist/components/SegmentedControl.svelte +35 -7
- package/dist/components/SegmentedControl.svelte.d.ts +13 -2
- package/dist/components/Select.svelte +16 -5
- package/dist/components/Select.svelte.d.ts +4 -0
- package/dist/components/Separator.svelte +2 -0
- package/dist/components/Separator.svelte.d.ts +2 -0
- package/dist/components/Skeleton.svelte +6 -3
- package/dist/components/Skeleton.svelte.d.ts +4 -1
- package/dist/components/SkipLink.svelte +1 -0
- package/dist/components/SkipLink.svelte.d.ts +1 -0
- package/dist/components/Slider.svelte +23 -2
- package/dist/components/Slider.svelte.d.ts +1 -0
- package/dist/components/Spinner.svelte +2 -0
- package/dist/components/Spinner.svelte.d.ts +2 -0
- package/dist/components/Switch.svelte +25 -2
- package/dist/components/Switch.svelte.d.ts +2 -0
- package/dist/components/Tab.svelte +16 -2
- package/dist/components/Tab.svelte.d.ts +1 -0
- package/dist/components/TabList.svelte +1 -0
- package/dist/components/TabList.svelte.d.ts +1 -0
- package/dist/components/TabPanel.svelte +8 -1
- package/dist/components/TabPanel.svelte.d.ts +1 -0
- package/dist/components/Table.svelte +30 -0
- package/dist/components/Table.svelte.d.ts +17 -0
- package/dist/components/Tabs.svelte +41 -19
- package/dist/components/Tabs.svelte.d.ts +6 -1
- package/dist/components/Textarea.svelte +26 -6
- package/dist/components/Textarea.svelte.d.ts +5 -0
- package/dist/components/ToastRegion.svelte +18 -2
- package/dist/components/ToastRegion.svelte.d.ts +8 -1
- package/dist/components/Toc.svelte +19 -8
- package/dist/components/Toc.svelte.d.ts +6 -0
- package/dist/components/Tooltip.svelte +59 -20
- package/dist/components/Tooltip.svelte.d.ts +16 -7
- package/dist/context.d.ts +84 -8
- package/dist/context.js +60 -11
- package/dist/index.d.ts +8 -4
- package/dist/index.js +6 -4
- package/dist/toast.d.ts +12 -7
- package/dist/toast.js +20 -11
- package/dist/useEnhancer.svelte.d.ts +40 -0
- package/dist/useEnhancer.svelte.js +58 -0
- package/package.json +4 -4
- package/dist/actions.d.ts +0 -25
- package/dist/actions.js +0 -31
|
@@ -1,47 +1,58 @@
|
|
|
1
1
|
<script lang="ts">
|
|
2
|
-
import { enhanceDrawer
|
|
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. */
|
|
12
|
+
defaultOpen?: boolean;
|
|
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`. */
|
|
11
18
|
closeOnBackdrop?: boolean;
|
|
19
|
+
/** Drawer content; compose with `<DrawerHeader>`, `<DrawerBody>`, `<DrawerFooter>`. */
|
|
12
20
|
children?: Snippet;
|
|
13
21
|
}
|
|
14
22
|
|
|
15
23
|
let {
|
|
16
|
-
|
|
17
|
-
|
|
24
|
+
defaultOpen = false,
|
|
25
|
+
open = $bindable(),
|
|
26
|
+
onOpenChange,
|
|
27
|
+
side = 'end',
|
|
18
28
|
closeOnBackdrop = true,
|
|
19
29
|
class: klass,
|
|
20
30
|
children,
|
|
21
31
|
...rest
|
|
22
32
|
}: Props = $props();
|
|
23
|
-
|
|
24
|
-
|
|
33
|
+
// svelte-ignore state_referenced_locally -- seeds the uncontrolled initial value once
|
|
34
|
+
if (open === undefined) open = defaultOpen;
|
|
25
35
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
return () => {
|
|
35
|
-
handle.destroy();
|
|
36
|
-
api = null;
|
|
37
|
-
};
|
|
38
|
-
});
|
|
36
|
+
const drawer = useEnhancer(enhanceDrawer, () => ({
|
|
37
|
+
closeOnBackdrop,
|
|
38
|
+
defaultOpen: untrack(() => open),
|
|
39
|
+
onOpenChange: (next) => {
|
|
40
|
+
open = next;
|
|
41
|
+
onOpenChange?.(next);
|
|
42
|
+
},
|
|
43
|
+
}));
|
|
39
44
|
|
|
40
45
|
$effect(() => {
|
|
41
|
-
api?.setOpen(open);
|
|
46
|
+
if (open != null) drawer.api?.setOpen(open);
|
|
42
47
|
});
|
|
43
48
|
</script>
|
|
44
49
|
|
|
45
|
-
<dialog
|
|
50
|
+
<dialog
|
|
51
|
+
{...rest}
|
|
52
|
+
class={['hl-drawer', klass]}
|
|
53
|
+
data-hl-drawer
|
|
54
|
+
data-hl-side={side}
|
|
55
|
+
{@attach drawer.attach}
|
|
56
|
+
>
|
|
46
57
|
{@render children?.()}
|
|
47
58
|
</dialog>
|
|
@@ -3,8 +3,15 @@ import type { HTMLDialogAttributes } from 'svelte/elements';
|
|
|
3
3
|
interface Props extends HTMLDialogAttributes {
|
|
4
4
|
/** Open state; two-way bindable (`bind:open`). */
|
|
5
5
|
open?: boolean;
|
|
6
|
-
|
|
6
|
+
/** Open the drawer initially for uncontrolled usage. */
|
|
7
|
+
defaultOpen?: boolean;
|
|
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`. */
|
|
7
13
|
closeOnBackdrop?: boolean;
|
|
14
|
+
/** Drawer content; compose with `<DrawerHeader>`, `<DrawerBody>`, `<DrawerFooter>`. */
|
|
8
15
|
children?: Snippet;
|
|
9
16
|
}
|
|
10
17
|
declare const Drawer: import("svelte").Component<Props, {}, "open">;
|
|
@@ -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, {}, "">;
|
|
@@ -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, {}, "">;
|
|
@@ -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,43 +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;
|
|
12
|
+
/** Open the menu initially for uncontrolled usage. */
|
|
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>`. */
|
|
15
26
|
children?: Snippet;
|
|
16
27
|
}
|
|
17
28
|
|
|
18
|
-
let {
|
|
19
|
-
|
|
20
|
-
|
|
29
|
+
let {
|
|
30
|
+
open = $bindable(),
|
|
31
|
+
defaultOpen = false,
|
|
32
|
+
onOpenChange,
|
|
33
|
+
onSelect,
|
|
34
|
+
closeOnSelect = true,
|
|
35
|
+
placement,
|
|
36
|
+
children,
|
|
37
|
+
...rest
|
|
38
|
+
}: Props = $props();
|
|
39
|
+
// svelte-ignore state_referenced_locally -- seeds the uncontrolled initial value once
|
|
40
|
+
if (open === undefined) open = defaultOpen;
|
|
21
41
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
});
|
|
29
|
-
api = handle.api;
|
|
30
|
-
return () => {
|
|
31
|
-
handle.destroy();
|
|
32
|
-
api = null;
|
|
33
|
-
};
|
|
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}`,
|
|
34
48
|
});
|
|
35
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
|
+
|
|
36
61
|
$effect(() => {
|
|
37
|
-
api?.setOpen(open);
|
|
62
|
+
if (open != null) dropdown.api?.setOpen(open);
|
|
38
63
|
});
|
|
39
64
|
</script>
|
|
40
65
|
|
|
41
|
-
<div {...rest} data-hl-dropdown
|
|
66
|
+
<div {...rest} data-hl-dropdown {@attach dropdown.attach}>
|
|
42
67
|
{@render children?.()}
|
|
43
68
|
</div>
|
|
@@ -1,10 +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;
|
|
7
|
+
/** Open the menu initially for uncontrolled usage. */
|
|
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>`. */
|
|
8
21
|
children?: Snippet;
|
|
9
22
|
}
|
|
10
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
|
-
/**
|
|
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 {
|
|
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
|
|
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
|
-
/**
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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,17 +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 {
|
|
14
|
-
|
|
15
|
-
|
|
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();
|
|
43
|
+
// SSR-safe: $props.id() is stable across server and client renders.
|
|
44
|
+
const generatedId = $props.id();
|
|
45
|
+
const baseId = $derived(id ?? `hl-field-${generatedId}`);
|
|
46
|
+
const hasError = $derived(error != null && error !== '');
|
|
47
|
+
const isInvalid = $derived(invalid || hasError);
|
|
16
48
|
|
|
17
49
|
setFieldContext({
|
|
18
50
|
get id() {
|
|
@@ -25,7 +57,7 @@
|
|
|
25
57
|
return `${baseId}-error`;
|
|
26
58
|
},
|
|
27
59
|
get invalid() {
|
|
28
|
-
return
|
|
60
|
+
return isInvalid;
|
|
29
61
|
},
|
|
30
62
|
get required() {
|
|
31
63
|
return required;
|
|
@@ -33,6 +65,14 @@
|
|
|
33
65
|
});
|
|
34
66
|
</script>
|
|
35
67
|
|
|
36
|
-
<div
|
|
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}
|
|
37
75
|
{@render children?.()}
|
|
76
|
+
{#if description != null}<FieldHelp>{description}</FieldHelp>{/if}
|
|
77
|
+
{#if hasError}<FieldError>{error}</FieldError>{/if}
|
|
38
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
|
|
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={
|
|
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
|
|
11
|
+
let { id, class: klass, children, ...rest }: Props = $props();
|
|
12
|
+
const field = getFieldContext();
|
|
12
13
|
</script>
|
|
13
14
|
|
|
14
|
-
<p {...rest} id={
|
|
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
|
|
12
|
+
const field = getFieldContext();
|
|
12
13
|
</script>
|
|
13
14
|
|
|
14
15
|
<label
|
|
15
16
|
{...rest}
|
|
16
|
-
for={htmlFor ??
|
|
17
|
+
for={htmlFor ?? field?.id}
|
|
17
18
|
class={['hl-label', klass]}
|
|
18
|
-
data-hl-required={
|
|
19
|
+
data-hl-required={field?.required || undefined}
|
|
19
20
|
>
|
|
20
21
|
{@render children?.()}
|
|
21
22
|
</label>
|