@leve-ui/tooltip 0.0.0-stage → 0.0.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,4 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const tooltip = require("./tooltip.qwik.cjs");
4
+ exports.Tooltip = tooltip;
@@ -0,0 +1,4 @@
1
+ import * as tooltip from "./tooltip.qwik.mjs";
2
+ export {
3
+ tooltip as Tooltip
4
+ };
@@ -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 TooltipArrow = qwik.component$((props) => {
6
+ return /* @__PURE__ */ jsxRuntime.jsx("span", {
7
+ ...props,
8
+ "aria-hidden": "true",
9
+ "data-leve-tooltip-arrow": "",
10
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
11
+ });
12
+ });
13
+ exports.TooltipArrow = TooltipArrow;
@@ -0,0 +1,13 @@
1
+ import { jsx } from "@builder.io/qwik/jsx-runtime";
2
+ import { component$, Slot } from "@builder.io/qwik";
3
+ const TooltipArrow = component$((props) => {
4
+ return /* @__PURE__ */ jsx("span", {
5
+ ...props,
6
+ "aria-hidden": "true",
7
+ "data-leve-tooltip-arrow": "",
8
+ children: /* @__PURE__ */ jsx(Slot, {})
9
+ });
10
+ });
11
+ export {
12
+ TooltipArrow
13
+ };
@@ -0,0 +1,68 @@
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 tooltipContext = require("./tooltip-context.qwik.cjs");
7
+ const TooltipContent = qwik.component$(({ side, align, sideOffset, alignOffset, avoidCollisions, collisionPadding, arrowPadding, onPointerEnter$, onPointerLeave$, ...props }) => {
8
+ const context = qwik.useContext(tooltipContext.tooltipContextId);
9
+ const ref = qwik.useSignal();
10
+ const always = qwik.useComputed$(() => true);
11
+ const floating = qwik.useComputed$(() => ({
12
+ side: side ?? "top",
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-tooltip",
32
+ arrowSelector: "[data-leve-tooltip-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
+ role: "tooltip",
54
+ popover: "manual",
55
+ onPointerEnter$: [
56
+ enter$,
57
+ onPointerEnter$
58
+ ],
59
+ onPointerLeave$: [
60
+ leave$,
61
+ onPointerLeave$
62
+ ],
63
+ "data-leve-tooltip-content": "",
64
+ "data-state": context.open.value ? "open" : "closed",
65
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
66
+ });
67
+ });
68
+ exports.TooltipContent = TooltipContent;
@@ -0,0 +1,68 @@
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 { tooltipContextId } from "./tooltip-context.qwik.mjs";
5
+ const TooltipContent = component$(({ side, align, sideOffset, alignOffset, avoidCollisions, collisionPadding, arrowPadding, onPointerEnter$, onPointerLeave$, ...props }) => {
6
+ const context = useContext(tooltipContextId);
7
+ const ref = useSignal();
8
+ const always = useComputed$(() => true);
9
+ const floating = useComputed$(() => ({
10
+ side: side ?? "top",
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-tooltip",
30
+ arrowSelector: "[data-leve-tooltip-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
+ role: "tooltip",
52
+ popover: "manual",
53
+ onPointerEnter$: [
54
+ enter$,
55
+ onPointerEnter$
56
+ ],
57
+ onPointerLeave$: [
58
+ leave$,
59
+ onPointerLeave$
60
+ ],
61
+ "data-leve-tooltip-content": "",
62
+ "data-state": context.open.value ? "open" : "closed",
63
+ children: /* @__PURE__ */ jsx(Slot, {})
64
+ });
65
+ });
66
+ export {
67
+ TooltipContent
68
+ };
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const qwik = require("@builder.io/qwik");
4
+ const tooltipContextId = qwik.createContextId("leve-ui.tooltip");
5
+ exports.tooltipContextId = tooltipContextId;
@@ -0,0 +1,5 @@
1
+ import { createContextId } from "@builder.io/qwik";
2
+ const tooltipContextId = createContextId("leve-ui.tooltip");
3
+ export {
4
+ tooltipContextId
5
+ };
@@ -0,0 +1,64 @@
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 tooltipContext = require("./tooltip-context.qwik.cjs");
7
+ const TooltipRoot = 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 cancel$ = qwik.$(() => {
22
+ if (timer.value !== void 0) clearTimeout(timer.value);
23
+ timer.value = void 0;
24
+ });
25
+ const show$ = qwik.$(async (immediate) => {
26
+ await cancel$();
27
+ if (immediate) {
28
+ await setOpen$(true);
29
+ return;
30
+ }
31
+ timer.value = window.setTimeout(() => {
32
+ timer.value = void 0;
33
+ if (pointerOnTrigger.value || pointerOnContent.value) setOpen$(true);
34
+ }, openDelay ?? 700);
35
+ });
36
+ const hide$ = qwik.$(async (immediate) => {
37
+ await cancel$();
38
+ if (immediate) {
39
+ await setOpen$(false);
40
+ return;
41
+ }
42
+ timer.value = window.setTimeout(() => {
43
+ timer.value = void 0;
44
+ if (!(pointerOnTrigger.value || pointerOnContent.value)) setOpen$(false);
45
+ }, closeDelay ?? 300);
46
+ });
47
+ qwik.useContextProvider(tooltipContext.tooltipContextId, {
48
+ ids,
49
+ open,
50
+ setOpen$,
51
+ show$,
52
+ hide$,
53
+ cancel$,
54
+ pointerOnTrigger,
55
+ pointerOnContent
56
+ });
57
+ return /* @__PURE__ */ jsxRuntime.jsx("span", {
58
+ ...props,
59
+ "data-leve-tooltip": "",
60
+ "data-state": open.value ? "open" : "closed",
61
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
62
+ });
63
+ });
64
+ exports.TooltipRoot = TooltipRoot;
@@ -0,0 +1,64 @@
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 { tooltipContextId } from "./tooltip-context.qwik.mjs";
5
+ const TooltipRoot = 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 cancel$ = $(() => {
20
+ if (timer.value !== void 0) clearTimeout(timer.value);
21
+ timer.value = void 0;
22
+ });
23
+ const show$ = $(async (immediate) => {
24
+ await cancel$();
25
+ if (immediate) {
26
+ await setOpen$(true);
27
+ return;
28
+ }
29
+ timer.value = window.setTimeout(() => {
30
+ timer.value = void 0;
31
+ if (pointerOnTrigger.value || pointerOnContent.value) setOpen$(true);
32
+ }, openDelay ?? 700);
33
+ });
34
+ const hide$ = $(async (immediate) => {
35
+ await cancel$();
36
+ if (immediate) {
37
+ await setOpen$(false);
38
+ return;
39
+ }
40
+ timer.value = window.setTimeout(() => {
41
+ timer.value = void 0;
42
+ if (!(pointerOnTrigger.value || pointerOnContent.value)) setOpen$(false);
43
+ }, closeDelay ?? 300);
44
+ });
45
+ useContextProvider(tooltipContextId, {
46
+ ids,
47
+ open,
48
+ setOpen$,
49
+ show$,
50
+ hide$,
51
+ cancel$,
52
+ pointerOnTrigger,
53
+ pointerOnContent
54
+ });
55
+ return /* @__PURE__ */ jsx("span", {
56
+ ...props,
57
+ "data-leve-tooltip": "",
58
+ "data-state": open.value ? "open" : "closed",
59
+ children: /* @__PURE__ */ jsx(Slot, {})
60
+ });
61
+ });
62
+ export {
63
+ TooltipRoot
64
+ };
@@ -0,0 +1,51 @@
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 tooltipContext = require("./tooltip-context.qwik.cjs");
6
+ const TooltipTrigger = qwik.component$(({ as: Component = "button", type, onPointerEnter$, onPointerLeave$, onPointerDown$, onFocus$, onBlur$, ...props }) => {
7
+ const context = qwik.useContext(tooltipContext.tooltipContextId);
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.$(() => context.show$(true));
20
+ const blur$ = qwik.$(() => context.hide$(true));
21
+ return /* @__PURE__ */ jsxRuntime.jsx(Element, {
22
+ type: Component === "button" ? type ?? "button" : type,
23
+ ...props,
24
+ id: context.ids.trigger,
25
+ "aria-describedby": context.ids.content,
26
+ onPointerEnter$: [
27
+ enter$,
28
+ onPointerEnter$
29
+ ],
30
+ onPointerLeave$: [
31
+ leave$,
32
+ onPointerLeave$
33
+ ],
34
+ onPointerDown$: [
35
+ press$,
36
+ onPointerDown$
37
+ ],
38
+ onFocus$: [
39
+ focus$,
40
+ onFocus$
41
+ ],
42
+ onBlur$: [
43
+ blur$,
44
+ onBlur$
45
+ ],
46
+ "data-leve-tooltip-trigger": "",
47
+ "data-state": context.open.value ? "open" : "closed",
48
+ children: /* @__PURE__ */ jsxRuntime.jsx(qwik.Slot, {})
49
+ });
50
+ });
51
+ exports.TooltipTrigger = TooltipTrigger;
@@ -0,0 +1,51 @@
1
+ import { jsx } from "@builder.io/qwik/jsx-runtime";
2
+ import { component$, useContext, $, Slot } from "@builder.io/qwik";
3
+ import { tooltipContextId } from "./tooltip-context.qwik.mjs";
4
+ const TooltipTrigger = component$(({ as: Component = "button", type, onPointerEnter$, onPointerLeave$, onPointerDown$, onFocus$, onBlur$, ...props }) => {
5
+ const context = useContext(tooltipContextId);
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$ = $(() => context.show$(true));
18
+ const blur$ = $(() => context.hide$(true));
19
+ return /* @__PURE__ */ jsx(Element, {
20
+ type: Component === "button" ? type ?? "button" : type,
21
+ ...props,
22
+ id: context.ids.trigger,
23
+ "aria-describedby": context.ids.content,
24
+ onPointerEnter$: [
25
+ enter$,
26
+ onPointerEnter$
27
+ ],
28
+ onPointerLeave$: [
29
+ leave$,
30
+ onPointerLeave$
31
+ ],
32
+ onPointerDown$: [
33
+ press$,
34
+ onPointerDown$
35
+ ],
36
+ onFocus$: [
37
+ focus$,
38
+ onFocus$
39
+ ],
40
+ onBlur$: [
41
+ blur$,
42
+ onBlur$
43
+ ],
44
+ "data-leve-tooltip-trigger": "",
45
+ "data-state": context.open.value ? "open" : "closed",
46
+ children: /* @__PURE__ */ jsx(Slot, {})
47
+ });
48
+ });
49
+ export {
50
+ TooltipTrigger
51
+ };
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
+ const tooltipArrow = require("./tooltip-arrow.qwik.cjs");
4
+ const tooltipContent = require("./tooltip-content.qwik.cjs");
5
+ const tooltipRoot = require("./tooltip-root.qwik.cjs");
6
+ const tooltipTrigger = require("./tooltip-trigger.qwik.cjs");
7
+ exports.Arrow = tooltipArrow.TooltipArrow;
8
+ exports.Content = tooltipContent.TooltipContent;
9
+ exports.Root = tooltipRoot.TooltipRoot;
10
+ exports.Trigger = tooltipTrigger.TooltipTrigger;
@@ -0,0 +1,10 @@
1
+ import { TooltipArrow } from "./tooltip-arrow.qwik.mjs";
2
+ import { TooltipContent } from "./tooltip-content.qwik.mjs";
3
+ import { TooltipRoot } from "./tooltip-root.qwik.mjs";
4
+ import { TooltipTrigger } from "./tooltip-trigger.qwik.mjs";
5
+ export {
6
+ TooltipArrow as Arrow,
7
+ TooltipContent as Content,
8
+ TooltipRoot as Root,
9
+ TooltipTrigger as Trigger
10
+ };
@@ -0,0 +1,6 @@
1
+ export * as Tooltip from './tooltip';
2
+ export type { TooltipArrowProps } from './tooltip-arrow';
3
+ export type { TooltipContentProps } from './tooltip-content';
4
+ export type { TooltipIds } from './tooltip-context';
5
+ export type { TooltipRootProps } from './tooltip-root';
6
+ export type { TooltipTriggerProps } from './tooltip-trigger';
@@ -0,0 +1,8 @@
1
+ import { type PropsOf } from '@builder.io/qwik';
2
+ export type TooltipArrowProps = PropsOf<'span'>;
3
+ /**
4
+ * Content の中に置く矢印です。見た目(SVG や回転した四角など)は利用者が描きます。
5
+ * ライブラリは辺に沿った位置(インラインスタイル)と `data-side` だけを設定します(`adr/0030`)。
6
+ * 装飾なので `aria-hidden="true"` を出力します。
7
+ */
8
+ export declare const TooltipArrow: import("@builder.io/qwik").Component<{} & import("@builder.io/qwik").HTMLElementAttrs & import("@builder.io/qwik").QwikAttributes<HTMLSpanElement>>;
@@ -0,0 +1,49 @@
1
+ import { type PropsOf } from '@builder.io/qwik';
2
+ import { type FloatingAlign, type FloatingSide } from '@leve-ui/utils';
3
+ export type TooltipContentProps = PropsOf<'span'> & {
4
+ /**
5
+ * The side of the Trigger to place the tooltip on. It flips when there is no room.
6
+ * @default 'top'
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 tooltip 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 tooltip, in px.
36
+ * @default 0
37
+ */
38
+ arrowPadding?: number;
39
+ };
40
+ /**
41
+ * ツールチップ本体です。文中(`<p>` の中)にも置けるよう `<span>` を描画します。
42
+ * `role="tooltip"` と `popover="manual"` を出力し、最前面(top layer)に出します。
43
+ *
44
+ * - フォーカスは移しません。中にボタンなどの操作できる要素を置かないでください(Popover を使います)。
45
+ * - ポインタが Content の上にある間は閉じません(WCAG 1.4.13)。Escape で閉じます。
46
+ * - Floating UI で Trigger の隣に置き(`adr/0030`)、反転後の `data-side` / `data-align` と CSS 変数
47
+ * (`--leve-tooltip-anchor-width` など)を出力します。位置のインラインスタイルは機能上必要なため出力します。
48
+ */
49
+ export declare const TooltipContent: import("@builder.io/qwik").Component<TooltipContentProps>;
@@ -0,0 +1,23 @@
1
+ import { type QRL, type ReadonlySignal, type Signal } from '@builder.io/qwik';
2
+ export interface TooltipIds {
3
+ trigger: string;
4
+ content: string;
5
+ }
6
+ export interface TooltipContext {
7
+ ids: TooltipIds;
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
+ }
23
+ export declare const tooltipContextId: import("@builder.io/qwik").ContextId<TooltipContext>;
@@ -0,0 +1,33 @@
1
+ import { type PropsOf, type QRL, type Signal } from '@builder.io/qwik';
2
+ import { type TooltipIds } from './tooltip-context';
3
+ export type TooltipRootProps = PropsOf<'span'> & {
4
+ /** Overrides the element IDs of the parts. */
5
+ ids?: Partial<TooltipIds>;
6
+ /**
7
+ * Whether the tooltip 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 tooltip is shown or hidden by a user interaction. */
14
+ onOpenChange$?: QRL<(open: boolean) => void>;
15
+ /**
16
+ * The delay in ms before the tooltip opens when the pointer rests on the Trigger. Focus opens it at once.
17
+ * @default 700
18
+ */
19
+ openDelay?: number;
20
+ /**
21
+ * The delay in ms before the tooltip 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
+ * WAI-ARIA APG の Tooltip パターンに準拠します。Trigger にポインタを載せる(`openDelay` 後)か
30
+ * フォーカスすると表示し、離れる(`closeDelay` 後)かフォーカスが外れる、または Escape で隠します。
31
+ * ポインタを Content に移す間は閉じません(WCAG 1.4.13)。
32
+ */
33
+ export declare const TooltipRoot: import("@builder.io/qwik").Component<TooltipRootProps>;
@@ -0,0 +1,14 @@
1
+ import { type Component, type PropsOf } from '@builder.io/qwik';
2
+ export type TooltipTriggerProps = PropsOf<'button'> & {
3
+ /**
4
+ * The element or component to render instead of `<button>`. A component must spread the props it receives onto one element.
5
+ * @default 'button'
6
+ */
7
+ as?: keyof HTMLElementTagNameMap | Component<any>;
8
+ [key: string]: unknown;
9
+ };
10
+ /**
11
+ * ツールチップで説明される要素です。既定では `<button type="button">` を描画し、
12
+ * `aria-describedby` で Content を指します。`as` でリンクなどほかの要素やコンポーネントに差し替えられます。
13
+ */
14
+ export declare const TooltipTrigger: Component<TooltipTriggerProps>;
@@ -0,0 +1,4 @@
1
+ export { TooltipArrow as Arrow } from './tooltip-arrow';
2
+ export { TooltipContent as Content } from './tooltip-content';
3
+ export { TooltipRoot as Root } from './tooltip-root';
4
+ export { TooltipTrigger as Trigger } from './tooltip-trigger';
package/package.json CHANGED
@@ -1,6 +1,61 @@
1
1
  {
2
2
  "name": "@leve-ui/tooltip",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.0.0",
4
+ "description": "Headless, WAI-ARIA compliant Tooltip 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/tooltip"
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
+ "tooltip"
39
+ ],
40
+ "dependencies": {
41
+ "@leve-ui/utils": "0.1.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.