@leve-ui/hover-card 0.0.0-stage → 0.1.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 leve-ui contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,13 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const jsxRuntime = require("@builder.io/qwik/jsx-runtime");
4
+ const qwik = require("@builder.io/qwik");
5
+ const HoverCardArrow = qwik.component$((props) => {
6
+ return /* @__PURE__ */ jsxRuntime.jsx("span", {
7
+ ...props,
8
+ "aria-hidden": "true",
9
+ "data-leve-hover-card-arrow": "",
10
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
11
+ });
12
+ });
13
+ exports.HoverCardArrow = HoverCardArrow;
@@ -0,0 +1,13 @@
1
+ import { jsx } from "@builder.io/qwik/jsx-runtime";
2
+ import { component$, Slot } from "@builder.io/qwik";
3
+ const HoverCardArrow = component$((props) => {
4
+ return /* @__PURE__ */ jsx("span", {
5
+ ...props,
6
+ "aria-hidden": "true",
7
+ "data-leve-hover-card-arrow": "",
8
+ children: /* @__PURE__ */ jsx(Slot, {})
9
+ });
10
+ });
11
+ export {
12
+ HoverCardArrow
13
+ };
@@ -0,0 +1,67 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const jsxRuntime = require("@builder.io/qwik/jsx-runtime");
4
+ const qwik = require("@builder.io/qwik");
5
+ const utils = require("@leve-ui/utils");
6
+ const hoverCardContext = require("./hover-card-context.qwik.cjs");
7
+ const HoverCardContent = qwik.component$(({ side, align, sideOffset, alignOffset, avoidCollisions, collisionPadding, arrowPadding, onPointerEnter$, onPointerLeave$, ...props }) => {
8
+ const context = qwik.useContext(hoverCardContext.hoverCardContextId);
9
+ const ref = qwik.useSignal();
10
+ const always = qwik.useComputed$(() => true);
11
+ const floating = qwik.useComputed$(() => ({
12
+ side: side ?? "bottom",
13
+ align: align ?? "center",
14
+ sideOffset: sideOffset ?? 0,
15
+ alignOffset: alignOffset ?? 0,
16
+ avoidCollisions: avoidCollisions ?? true,
17
+ collisionPadding: collisionPadding ?? 0,
18
+ arrowPadding: arrowPadding ?? 0
19
+ }));
20
+ qwik.useVisibleTask$(({ track, cleanup }) => {
21
+ const open = track(() => context.open.value);
22
+ const options = track(() => floating.value);
23
+ const element = ref.value;
24
+ if (!element || !open) return;
25
+ cleanup(utils.openPopoverElement(element, {
26
+ open: context.open,
27
+ setOpen$: context.setOpen$,
28
+ trigger: utils.getElementByIdInContainer(element, context.ids.trigger),
29
+ floating: {
30
+ ...options,
31
+ cssVarPrefix: "--leve-hover-card",
32
+ arrowSelector: "[data-leve-hover-card-arrow]"
33
+ },
34
+ moveFocus: false,
35
+ closeOnEscape: always,
36
+ closeOnOutsideClick: always
37
+ }));
38
+ }, {
39
+ strategy: "document-ready"
40
+ });
41
+ const enter$ = qwik.$(() => {
42
+ context.pointerOnContent.value = true;
43
+ context.cancel$();
44
+ });
45
+ const leave$ = qwik.$(() => {
46
+ context.pointerOnContent.value = false;
47
+ context.hide$(false);
48
+ });
49
+ return /* @__PURE__ */ jsxRuntime.jsx("span", {
50
+ ...props,
51
+ ref,
52
+ id: context.ids.content,
53
+ popover: "manual",
54
+ onPointerEnter$: [
55
+ enter$,
56
+ onPointerEnter$
57
+ ],
58
+ onPointerLeave$: [
59
+ leave$,
60
+ onPointerLeave$
61
+ ],
62
+ "data-leve-hover-card-content": "",
63
+ "data-state": context.open.value ? "open" : "closed",
64
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
65
+ });
66
+ });
67
+ exports.HoverCardContent = HoverCardContent;
@@ -0,0 +1,67 @@
1
+ import { jsx } from "@builder.io/qwik/jsx-runtime";
2
+ import { component$, useContext, useSignal, useComputed$, useVisibleTask$, $, Slot } from "@builder.io/qwik";
3
+ import { openPopoverElement, getElementByIdInContainer } from "@leve-ui/utils";
4
+ import { hoverCardContextId } from "./hover-card-context.qwik.mjs";
5
+ const HoverCardContent = component$(({ side, align, sideOffset, alignOffset, avoidCollisions, collisionPadding, arrowPadding, onPointerEnter$, onPointerLeave$, ...props }) => {
6
+ const context = useContext(hoverCardContextId);
7
+ const ref = useSignal();
8
+ const always = useComputed$(() => true);
9
+ const floating = useComputed$(() => ({
10
+ side: side ?? "bottom",
11
+ align: align ?? "center",
12
+ sideOffset: sideOffset ?? 0,
13
+ alignOffset: alignOffset ?? 0,
14
+ avoidCollisions: avoidCollisions ?? true,
15
+ collisionPadding: collisionPadding ?? 0,
16
+ arrowPadding: arrowPadding ?? 0
17
+ }));
18
+ useVisibleTask$(({ track, cleanup }) => {
19
+ const open = track(() => context.open.value);
20
+ const options = track(() => floating.value);
21
+ const element = ref.value;
22
+ if (!element || !open) return;
23
+ cleanup(openPopoverElement(element, {
24
+ open: context.open,
25
+ setOpen$: context.setOpen$,
26
+ trigger: getElementByIdInContainer(element, context.ids.trigger),
27
+ floating: {
28
+ ...options,
29
+ cssVarPrefix: "--leve-hover-card",
30
+ arrowSelector: "[data-leve-hover-card-arrow]"
31
+ },
32
+ moveFocus: false,
33
+ closeOnEscape: always,
34
+ closeOnOutsideClick: always
35
+ }));
36
+ }, {
37
+ strategy: "document-ready"
38
+ });
39
+ const enter$ = $(() => {
40
+ context.pointerOnContent.value = true;
41
+ context.cancel$();
42
+ });
43
+ const leave$ = $(() => {
44
+ context.pointerOnContent.value = false;
45
+ context.hide$(false);
46
+ });
47
+ return /* @__PURE__ */ jsx("span", {
48
+ ...props,
49
+ ref,
50
+ id: context.ids.content,
51
+ popover: "manual",
52
+ onPointerEnter$: [
53
+ enter$,
54
+ onPointerEnter$
55
+ ],
56
+ onPointerLeave$: [
57
+ leave$,
58
+ onPointerLeave$
59
+ ],
60
+ "data-leve-hover-card-content": "",
61
+ "data-state": context.open.value ? "open" : "closed",
62
+ children: /* @__PURE__ */ jsx(Slot, {})
63
+ });
64
+ });
65
+ export {
66
+ HoverCardContent
67
+ };
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const qwik = require("@builder.io/qwik");
4
+ const hoverCardContextId = qwik.createContextId("leve-ui.hover-card");
5
+ exports.hoverCardContextId = hoverCardContextId;
@@ -0,0 +1,5 @@
1
+ import { createContextId } from "@builder.io/qwik";
2
+ const hoverCardContextId = createContextId("leve-ui.hover-card");
3
+ export {
4
+ hoverCardContextId
5
+ };
@@ -0,0 +1,66 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const jsxRuntime = require("@builder.io/qwik/jsx-runtime");
4
+ const qwik = require("@builder.io/qwik");
5
+ const utils = require("@leve-ui/utils");
6
+ const hoverCardContext = require("./hover-card-context.qwik.cjs");
7
+ const HoverCardRoot = qwik.component$(({ ids: propIds, defaultOpen = false, "bind:open": bindOpen, onOpenChange$, openDelay, closeDelay, ...props }) => {
8
+ const [open, setOpen$] = utils.useControllableState({
9
+ value: bindOpen,
10
+ defaultValue: defaultOpen ?? false,
11
+ onChange$: onOpenChange$
12
+ });
13
+ const base = qwik.useId();
14
+ const ids = {
15
+ trigger: propIds?.trigger ?? `${base}-trigger`,
16
+ content: propIds?.content ?? `${base}-content`
17
+ };
18
+ const timer = qwik.useSignal();
19
+ const pointerOnTrigger = qwik.useSignal(false);
20
+ const pointerOnContent = qwik.useSignal(false);
21
+ const focused = qwik.useSignal(false);
22
+ const cancel$ = qwik.$(() => {
23
+ if (timer.value !== void 0) clearTimeout(timer.value);
24
+ timer.value = void 0;
25
+ });
26
+ const show$ = qwik.$(async (immediate) => {
27
+ await cancel$();
28
+ if (immediate) {
29
+ await setOpen$(true);
30
+ return;
31
+ }
32
+ timer.value = window.setTimeout(() => {
33
+ timer.value = void 0;
34
+ if (pointerOnTrigger.value || pointerOnContent.value || focused.value) setOpen$(true);
35
+ }, openDelay ?? 700);
36
+ });
37
+ const hide$ = qwik.$(async (immediate) => {
38
+ await cancel$();
39
+ if (immediate) {
40
+ await setOpen$(false);
41
+ return;
42
+ }
43
+ timer.value = window.setTimeout(() => {
44
+ timer.value = void 0;
45
+ if (!(pointerOnTrigger.value || pointerOnContent.value) && !focused.value) setOpen$(false);
46
+ }, closeDelay ?? 300);
47
+ });
48
+ qwik.useContextProvider(hoverCardContext.hoverCardContextId, {
49
+ ids,
50
+ open,
51
+ setOpen$,
52
+ show$,
53
+ hide$,
54
+ cancel$,
55
+ pointerOnTrigger,
56
+ pointerOnContent,
57
+ focused
58
+ });
59
+ return /* @__PURE__ */ jsxRuntime.jsx("span", {
60
+ ...props,
61
+ "data-leve-hover-card": "",
62
+ "data-state": open.value ? "open" : "closed",
63
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
64
+ });
65
+ });
66
+ exports.HoverCardRoot = HoverCardRoot;
@@ -0,0 +1,66 @@
1
+ import { jsx } from "@builder.io/qwik/jsx-runtime";
2
+ import { component$, useId, useSignal, $, useContextProvider, Slot } from "@builder.io/qwik";
3
+ import { useControllableState } from "@leve-ui/utils";
4
+ import { hoverCardContextId } from "./hover-card-context.qwik.mjs";
5
+ const HoverCardRoot = component$(({ ids: propIds, defaultOpen = false, "bind:open": bindOpen, onOpenChange$, openDelay, closeDelay, ...props }) => {
6
+ const [open, setOpen$] = useControllableState({
7
+ value: bindOpen,
8
+ defaultValue: defaultOpen ?? false,
9
+ onChange$: onOpenChange$
10
+ });
11
+ const base = useId();
12
+ const ids = {
13
+ trigger: propIds?.trigger ?? `${base}-trigger`,
14
+ content: propIds?.content ?? `${base}-content`
15
+ };
16
+ const timer = useSignal();
17
+ const pointerOnTrigger = useSignal(false);
18
+ const pointerOnContent = useSignal(false);
19
+ const focused = useSignal(false);
20
+ const cancel$ = $(() => {
21
+ if (timer.value !== void 0) clearTimeout(timer.value);
22
+ timer.value = void 0;
23
+ });
24
+ const show$ = $(async (immediate) => {
25
+ await cancel$();
26
+ if (immediate) {
27
+ await setOpen$(true);
28
+ return;
29
+ }
30
+ timer.value = window.setTimeout(() => {
31
+ timer.value = void 0;
32
+ if (pointerOnTrigger.value || pointerOnContent.value || focused.value) setOpen$(true);
33
+ }, openDelay ?? 700);
34
+ });
35
+ const hide$ = $(async (immediate) => {
36
+ await cancel$();
37
+ if (immediate) {
38
+ await setOpen$(false);
39
+ return;
40
+ }
41
+ timer.value = window.setTimeout(() => {
42
+ timer.value = void 0;
43
+ if (!(pointerOnTrigger.value || pointerOnContent.value) && !focused.value) setOpen$(false);
44
+ }, closeDelay ?? 300);
45
+ });
46
+ useContextProvider(hoverCardContextId, {
47
+ ids,
48
+ open,
49
+ setOpen$,
50
+ show$,
51
+ hide$,
52
+ cancel$,
53
+ pointerOnTrigger,
54
+ pointerOnContent,
55
+ focused
56
+ });
57
+ return /* @__PURE__ */ jsx("span", {
58
+ ...props,
59
+ "data-leve-hover-card": "",
60
+ "data-state": open.value ? "open" : "closed",
61
+ children: /* @__PURE__ */ jsx(Slot, {})
62
+ });
63
+ });
64
+ export {
65
+ HoverCardRoot
66
+ };
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const jsxRuntime = require("@builder.io/qwik/jsx-runtime");
4
+ const qwik = require("@builder.io/qwik");
5
+ const hoverCardContext = require("./hover-card-context.qwik.cjs");
6
+ const HoverCardTrigger = qwik.component$(({ as: Component = "a", onPointerEnter$, onPointerLeave$, onPointerDown$, onFocus$, onBlur$, ...props }) => {
7
+ const context = qwik.useContext(hoverCardContext.hoverCardContextId);
8
+ const Element = Component;
9
+ const enter$ = qwik.$((event) => {
10
+ if (event.pointerType === "touch") return;
11
+ context.pointerOnTrigger.value = true;
12
+ context.show$(false);
13
+ });
14
+ const leave$ = qwik.$(() => {
15
+ context.pointerOnTrigger.value = false;
16
+ context.hide$(false);
17
+ });
18
+ const press$ = qwik.$(() => context.hide$(true));
19
+ const focus$ = qwik.$(() => {
20
+ context.focused.value = true;
21
+ context.show$(false);
22
+ });
23
+ const blur$ = qwik.$(() => {
24
+ context.focused.value = false;
25
+ context.hide$(true);
26
+ });
27
+ return /* @__PURE__ */ jsxRuntime.jsx(Element, {
28
+ ...props,
29
+ id: context.ids.trigger,
30
+ onPointerEnter$: [
31
+ enter$,
32
+ onPointerEnter$
33
+ ],
34
+ onPointerLeave$: [
35
+ leave$,
36
+ onPointerLeave$
37
+ ],
38
+ onPointerDown$: [
39
+ press$,
40
+ onPointerDown$
41
+ ],
42
+ onFocus$: [
43
+ focus$,
44
+ onFocus$
45
+ ],
46
+ onBlur$: [
47
+ blur$,
48
+ onBlur$
49
+ ],
50
+ "data-leve-hover-card-trigger": "",
51
+ "data-state": context.open.value ? "open" : "closed",
52
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
53
+ });
54
+ });
55
+ exports.HoverCardTrigger = HoverCardTrigger;
@@ -0,0 +1,55 @@
1
+ import { jsx } from "@builder.io/qwik/jsx-runtime";
2
+ import { component$, useContext, $, Slot } from "@builder.io/qwik";
3
+ import { hoverCardContextId } from "./hover-card-context.qwik.mjs";
4
+ const HoverCardTrigger = component$(({ as: Component = "a", onPointerEnter$, onPointerLeave$, onPointerDown$, onFocus$, onBlur$, ...props }) => {
5
+ const context = useContext(hoverCardContextId);
6
+ const Element = Component;
7
+ const enter$ = $((event) => {
8
+ if (event.pointerType === "touch") return;
9
+ context.pointerOnTrigger.value = true;
10
+ context.show$(false);
11
+ });
12
+ const leave$ = $(() => {
13
+ context.pointerOnTrigger.value = false;
14
+ context.hide$(false);
15
+ });
16
+ const press$ = $(() => context.hide$(true));
17
+ const focus$ = $(() => {
18
+ context.focused.value = true;
19
+ context.show$(false);
20
+ });
21
+ const blur$ = $(() => {
22
+ context.focused.value = false;
23
+ context.hide$(true);
24
+ });
25
+ return /* @__PURE__ */ jsx(Element, {
26
+ ...props,
27
+ id: context.ids.trigger,
28
+ onPointerEnter$: [
29
+ enter$,
30
+ onPointerEnter$
31
+ ],
32
+ onPointerLeave$: [
33
+ leave$,
34
+ onPointerLeave$
35
+ ],
36
+ onPointerDown$: [
37
+ press$,
38
+ onPointerDown$
39
+ ],
40
+ onFocus$: [
41
+ focus$,
42
+ onFocus$
43
+ ],
44
+ onBlur$: [
45
+ blur$,
46
+ onBlur$
47
+ ],
48
+ "data-leve-hover-card-trigger": "",
49
+ "data-state": context.open.value ? "open" : "closed",
50
+ children: /* @__PURE__ */ jsx(Slot, {})
51
+ });
52
+ });
53
+ export {
54
+ HoverCardTrigger
55
+ };
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const hoverCardArrow = require("./hover-card-arrow.qwik.cjs");
4
+ const hoverCardContent = require("./hover-card-content.qwik.cjs");
5
+ const hoverCardRoot = require("./hover-card-root.qwik.cjs");
6
+ const hoverCardTrigger = require("./hover-card-trigger.qwik.cjs");
7
+ exports.Arrow = hoverCardArrow.HoverCardArrow;
8
+ exports.Content = hoverCardContent.HoverCardContent;
9
+ exports.Root = hoverCardRoot.HoverCardRoot;
10
+ exports.Trigger = hoverCardTrigger.HoverCardTrigger;
@@ -0,0 +1,10 @@
1
+ import { HoverCardArrow } from "./hover-card-arrow.qwik.mjs";
2
+ import { HoverCardContent } from "./hover-card-content.qwik.mjs";
3
+ import { HoverCardRoot } from "./hover-card-root.qwik.mjs";
4
+ import { HoverCardTrigger } from "./hover-card-trigger.qwik.mjs";
5
+ export {
6
+ HoverCardArrow as Arrow,
7
+ HoverCardContent as Content,
8
+ HoverCardRoot as Root,
9
+ HoverCardTrigger as Trigger
10
+ };
@@ -0,0 +1,4 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const hoverCard = require("./hover-card.qwik.cjs");
4
+ exports.HoverCard = hoverCard;
@@ -0,0 +1,4 @@
1
+ import * as hoverCard from "./hover-card.qwik.mjs";
2
+ export {
3
+ hoverCard as HoverCard
4
+ };
@@ -0,0 +1,8 @@
1
+ import { type PropsOf } from '@builder.io/qwik';
2
+ export type HoverCardArrowProps = PropsOf<'span'>;
3
+ /**
4
+ * Content の中に置く矢印です。見た目(SVG や回転した四角など)は利用者が描きます。
5
+ * ライブラリは辺に沿った位置(インラインスタイル)と `data-side` だけを設定します(`adr/0030`)。
6
+ * 装飾なので `aria-hidden="true"` を出力します。
7
+ */
8
+ export declare const HoverCardArrow: import("@builder.io/qwik").Component<{} & import("@builder.io/qwik").HTMLElementAttrs & import("@builder.io/qwik").QwikAttributes<HTMLSpanElement>>;
@@ -0,0 +1,51 @@
1
+ import { type PropsOf } from '@builder.io/qwik';
2
+ import { type FloatingAlign, type FloatingSide } from '@leve-ui/utils';
3
+ export type HoverCardContentProps = PropsOf<'span'> & {
4
+ /**
5
+ * The side of the Trigger to place the card on. It flips when there is no room.
6
+ * @default 'bottom'
7
+ */
8
+ side?: FloatingSide;
9
+ /**
10
+ * The alignment along that side.
11
+ * @default 'center'
12
+ */
13
+ align?: FloatingAlign;
14
+ /**
15
+ * The distance from the Trigger in px.
16
+ * @default 0
17
+ */
18
+ sideOffset?: number;
19
+ /**
20
+ * The offset along the side in px.
21
+ * @default 0
22
+ */
23
+ alignOffset?: number;
24
+ /**
25
+ * Whether to flip and shift the card to keep it in the viewport.
26
+ * @default true
27
+ */
28
+ avoidCollisions?: boolean;
29
+ /**
30
+ * The padding from the viewport edges when avoiding collisions, in px.
31
+ * @default 0
32
+ */
33
+ collisionPadding?: number;
34
+ /**
35
+ * The padding between the arrow and the corners of the card, in px.
36
+ * @default 0
37
+ */
38
+ arrowPadding?: number;
39
+ };
40
+ /**
41
+ * ホバーカード本体(リンク先のプレビュー)です。文中(`<p>` の中)にも置けるよう `<span>` を描画します。
42
+ * `popover="manual"` で最前面(top layer)に出します。
43
+ *
44
+ * - 補足のプレビューなので `role` は付けず、Trigger とも ARIA で関連付けません。フォーカスも移しません。
45
+ * Content にしかない情報や操作を置かず、リンク先でも同じ情報を得られるようにしてください。
46
+ * - ポインタが Content の上にある間は閉じません(WCAG 1.4.13)。中のリンクはクリックできます。
47
+ * Escape で閉じます。
48
+ * - Floating UI で Trigger の隣に置き(`adr/0030`)、反転後の `data-side` / `data-align` と CSS 変数
49
+ * (`--leve-hover-card-anchor-width` など)を出力します。位置のインラインスタイルは機能上必要なため出力します。
50
+ */
51
+ export declare const HoverCardContent: import("@builder.io/qwik").Component<HoverCardContentProps>;
@@ -0,0 +1,25 @@
1
+ import { type QRL, type ReadonlySignal, type Signal } from '@builder.io/qwik';
2
+ export interface HoverCardIds {
3
+ trigger: string;
4
+ content: string;
5
+ }
6
+ export interface HoverCardContext {
7
+ ids: HoverCardIds;
8
+ open: ReadonlySignal<boolean>;
9
+ setOpen$: QRL<(open: boolean) => Promise<void>>;
10
+ /** Opens after `openDelay` (pointer), or at once with `immediate` (focus) */
11
+ show$: QRL<(immediate: boolean) => void>;
12
+ /** Closes after `closeDelay` (pointer), or at once with `immediate` (blur, press) */
13
+ hide$: QRL<(immediate: boolean) => void>;
14
+ /** Cancels a pending open or close */
15
+ cancel$: QRL<() => void>;
16
+ /**
17
+ * Whether the pointer is on the Trigger / on the Content. Kept apart, since the async handlers
18
+ * of both elements may run in any order; pending opens and closes check them when they fire.
19
+ */
20
+ pointerOnTrigger: Signal<boolean>;
21
+ pointerOnContent: Signal<boolean>;
22
+ /** Whether the Trigger has focus. A pending open by focus checks it when it fires. */
23
+ focused: Signal<boolean>;
24
+ }
25
+ export declare const hoverCardContextId: import("@builder.io/qwik").ContextId<HoverCardContext>;
@@ -0,0 +1,33 @@
1
+ import { type PropsOf, type QRL, type Signal } from '@builder.io/qwik';
2
+ import { type HoverCardIds } from './hover-card-context';
3
+ export type HoverCardRootProps = PropsOf<'span'> & {
4
+ /** Overrides the element IDs of the parts. */
5
+ ids?: Partial<HoverCardIds>;
6
+ /**
7
+ * Whether the card is shown initially (uncontrolled).
8
+ * @default false
9
+ */
10
+ defaultOpen?: boolean;
11
+ /** A signal with the open state (controlled). */
12
+ 'bind:open'?: Signal<boolean>;
13
+ /** Called when the card is shown or hidden by a user interaction. */
14
+ onOpenChange$?: QRL<(open: boolean) => void>;
15
+ /**
16
+ * The delay in ms before the card opens when the pointer rests on the Trigger or the Trigger is focused.
17
+ * @default 700
18
+ */
19
+ openDelay?: number;
20
+ /**
21
+ * The delay in ms before the card closes when the pointer leaves, so that the pointer can move onto it.
22
+ * @default 300
23
+ */
24
+ closeDelay?: number;
25
+ };
26
+ /**
27
+ * ホバーカード(リンク先のプレビュー)のルート要素です。インライン要素の `<span>` を描画します。
28
+ *
29
+ * 該当する APG パターンはありません。Trigger のリンクにポインタを載せるかフォーカスすると
30
+ * `openDelay` 後に表示し、離れる(`closeDelay` 後)かフォーカスが外れる、または Escape で隠します。
31
+ * ポインタを Content に移す間は閉じません(WCAG 1.4.13)。
32
+ */
33
+ export declare const HoverCardRoot: import("@builder.io/qwik").Component<HoverCardRootProps>;
@@ -0,0 +1,14 @@
1
+ import { type Component, type PropsOf } from '@builder.io/qwik';
2
+ export type HoverCardTriggerProps = PropsOf<'a'> & {
3
+ /**
4
+ * The element or component to render instead of `<a>`. A component must spread the props it receives onto one element.
5
+ * @default 'a'
6
+ */
7
+ as?: keyof HTMLElementTagNameMap | Component<any>;
8
+ [key: string]: unknown;
9
+ };
10
+ /**
11
+ * ホバーカードを開くリンクです。既定では `<a>` を描画します(`href` を渡してください)。
12
+ * `as` で Qwik City の `<Link>` などほかの要素やコンポーネントに差し替えられます。
13
+ */
14
+ export declare const HoverCardTrigger: Component<HoverCardTriggerProps>;
@@ -0,0 +1,4 @@
1
+ export { HoverCardArrow as Arrow } from './hover-card-arrow';
2
+ export { HoverCardContent as Content } from './hover-card-content';
3
+ export { HoverCardRoot as Root } from './hover-card-root';
4
+ export { HoverCardTrigger as Trigger } from './hover-card-trigger';
@@ -0,0 +1,6 @@
1
+ export * as HoverCard from './hover-card';
2
+ export type { HoverCardArrowProps } from './hover-card-arrow';
3
+ export type { HoverCardContentProps } from './hover-card-content';
4
+ export type { HoverCardIds } from './hover-card-context';
5
+ export type { HoverCardRootProps } from './hover-card-root';
6
+ export type { HoverCardTriggerProps } from './hover-card-trigger';
package/package.json CHANGED
@@ -1,6 +1,61 @@
1
1
  {
2
2
  "name": "@leve-ui/hover-card",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.0",
4
+ "description": "Headless, WAI-ARIA compliant HoverCard component for Qwik. Bring your own styles.",
5
+ "homepage": "https://github.com/leve-ui/leve-ui#readme",
6
+ "bugs": {
7
+ "url": "https://github.com/leve-ui/leve-ui/issues"
8
+ },
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/leve-ui/leve-ui.git",
12
+ "directory": "packages/components/hover-card"
13
+ },
14
+ "license": "MIT",
15
+ "type": "module",
16
+ "sideEffects": false,
17
+ "main": "./lib/index.qwik.cjs",
18
+ "module": "./lib/index.qwik.mjs",
19
+ "qwik": "./lib/index.qwik.mjs",
20
+ "types": "./lib-types/index.d.ts",
21
+ "exports": {
22
+ ".": {
23
+ "@leve-ui/source": "./src/index.ts",
24
+ "types": "./lib-types/index.d.ts",
25
+ "import": "./lib/index.qwik.mjs",
26
+ "require": "./lib/index.qwik.cjs"
27
+ }
28
+ },
29
+ "files": [
30
+ "lib",
31
+ "lib-types"
32
+ ],
33
+ "keywords": [
34
+ "qwik",
35
+ "headless-ui",
36
+ "accessibility",
37
+ "wai-aria",
38
+ "hover-card"
39
+ ],
40
+ "dependencies": {
41
+ "@leve-ui/utils": "0.2.0"
42
+ },
43
+ "peerDependencies": {
44
+ "@builder.io/qwik": "^1.20.4"
45
+ },
46
+ "devDependencies": {
47
+ "@builder.io/qwik": "1.20.4",
48
+ "typescript": "~5.9.3",
49
+ "vite": "^7.3.8",
50
+ "vitest": "^5.1.0",
51
+ "@leve-ui/tsconfig": "0.0.0",
52
+ "@leve-ui/vite-config": "0.0.0"
53
+ },
54
+ "scripts": {
55
+ "build": "pnpm build:lib && pnpm build:types",
56
+ "build:lib": "vite build --mode lib",
57
+ "build:types": "tsc -p tsconfig.build.json",
58
+ "typecheck": "tsc --noEmit",
59
+ "test": "vitest run"
60
+ }
6
61
  }
package/README.md DELETED
@@ -1,3 +0,0 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.