@gridui/popover 0.0.0-stage → 1.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/README.md CHANGED
@@ -1,3 +1,8 @@
1
- # Temporary Holding Version
1
+ # @gridui/popover
2
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.
3
+ Core family. Public API: `Popover`, `PopoverAnchor`, `PopoverClose`, `PopoverPanel`, `PopoverPanelProps`, `PopoverProps`, `PopoverTrigger`, `PopoverTriggerProps`.
4
+
5
+ Import components from `@gridui/popover` and load `@gridui/popover/styles.css` after Theme.
6
+ Load styles for any composed dependency used by this family. Applications own routes, labels, state persistence, and branding.
7
+
8
+ See [component ownership](../../docs/component-ownership.md) and [release history](.changeset/history/).
@@ -0,0 +1,14 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace Root
5
+ * @description Index
6
+ */
7
+ export type { PopoverProps } from "./popover/popover";
8
+ export { Popover } from "./popover/popover";
9
+ export { PopoverAnchor } from "./popover-anchor/popover-anchor";
10
+ export { PopoverClose } from "./popover-close/popover-close";
11
+ export type { PopoverPanelProps } from "./popover-panel/popover-panel";
12
+ export { PopoverPanel } from "./popover-panel/popover-panel";
13
+ export type { PopoverTriggerProps } from "./popover-trigger/popover-trigger";
14
+ export { PopoverTrigger } from "./popover-trigger/popover-trigger";
package/dist/index.js ADDED
@@ -0,0 +1,301 @@
1
+ // src/shared/context.ts
2
+ import { createContext } from "react";
3
+ var Interaction = createContext(null);
4
+
5
+ // src/popover/hover-intent.ts
6
+ var createHoverIntent = (open, close) => {
7
+ let timer;
8
+ let dismissed = false;
9
+ const cancel = () => {
10
+ clearTimeout(timer);
11
+ timer = void 0;
12
+ };
13
+ return {
14
+ enter(alreadyOpen) {
15
+ cancel();
16
+ if (!dismissed && !alreadyOpen) {
17
+ timer = setTimeout(open, 150);
18
+ }
19
+ },
20
+ leave(shouldClose) {
21
+ cancel();
22
+ dismissed = false;
23
+ if (shouldClose) {
24
+ timer = setTimeout(close, 250);
25
+ }
26
+ },
27
+ dismiss() {
28
+ cancel();
29
+ dismissed = true;
30
+ },
31
+ cancel
32
+ };
33
+ };
34
+
35
+ // src/popover/popover.tsx
36
+ import { OverlayOpen, useOverlayState } from "@gridui/overlay";
37
+ import * as Primitive from "@radix-ui/react-popover";
38
+ import { useEffect, useMemo, useRef } from "react";
39
+ import { jsx } from "react/jsx-runtime";
40
+ var Popover = (props) => {
41
+ const {
42
+ open: controlledOpen,
43
+ defaultOpen = false,
44
+ onOpenChange,
45
+ hoverEnabled = true,
46
+ ...restProps
47
+ } = props;
48
+ const { open, onOpenChange: change } = useOverlayState({
49
+ open: controlledOpen,
50
+ defaultOpen,
51
+ onOpenChange
52
+ });
53
+ const hoverOpened = useRef(false);
54
+ const openRef = useRef(open);
55
+ const changeRef = useRef(change);
56
+ const hoverTarget = useRef(null);
57
+ useEffect(() => {
58
+ openRef.current = open;
59
+ changeRef.current = change;
60
+ }, [
61
+ open,
62
+ change
63
+ ]);
64
+ const intent = useMemo(() => {
65
+ return createHoverIntent(() => {
66
+ if (!hoverTarget.current?.isConnected || hoverTarget.current.matches(":disabled, [aria-disabled='true']")) {
67
+ return;
68
+ }
69
+ hoverOpened.current = true;
70
+ changeRef.current(true);
71
+ }, () => {
72
+ changeRef.current(false);
73
+ });
74
+ }, []);
75
+ useEffect(() => {
76
+ return intent.cancel;
77
+ }, [intent]);
78
+ useEffect(() => {
79
+ if (!hoverEnabled) {
80
+ intent.cancel();
81
+ }
82
+ }, [
83
+ hoverEnabled,
84
+ intent
85
+ ]);
86
+ useEffect(() => {
87
+ if (!open) {
88
+ intent.cancel();
89
+ }
90
+ }, [
91
+ intent,
92
+ open
93
+ ]);
94
+ const interaction = {
95
+ hoverOpened,
96
+ enter(event) {
97
+ if (hoverEnabled && event.pointerType === "mouse" && !event.currentTarget.matches(":disabled, [aria-disabled='true']") && window.matchMedia("(hover: hover) and (pointer: fine)").matches) {
98
+ hoverTarget.current = event.currentTarget;
99
+ intent.enter(openRef.current);
100
+ }
101
+ },
102
+ leave(event) {
103
+ const focused = event.currentTarget.contains(document.activeElement);
104
+ intent.leave(hoverOpened.current && !focused);
105
+ },
106
+ activate() {
107
+ intent.cancel();
108
+ hoverOpened.current = false;
109
+ },
110
+ dismiss() {
111
+ intent.dismiss();
112
+ hoverOpened.current = false;
113
+ }
114
+ };
115
+ return /* @__PURE__ */ jsx(
116
+ Interaction.Provider,
117
+ {
118
+ value: interaction,
119
+ children: /* @__PURE__ */ jsx(
120
+ OverlayOpen.Provider,
121
+ {
122
+ value: open,
123
+ children: /* @__PURE__ */ jsx(
124
+ Primitive.Root,
125
+ {
126
+ ...restProps,
127
+ open,
128
+ onOpenChange: (next) => {
129
+ if (!next) {
130
+ interaction.dismiss();
131
+ }
132
+ change(next);
133
+ }
134
+ }
135
+ )
136
+ }
137
+ )
138
+ }
139
+ );
140
+ };
141
+
142
+ // src/popover-anchor/popover-anchor.tsx
143
+ import * as Primitive2 from "@radix-ui/react-popover";
144
+ var PopoverAnchor = Primitive2.Anchor;
145
+
146
+ // src/popover-close/popover-close.tsx
147
+ import * as Primitive3 from "@radix-ui/react-popover";
148
+ var PopoverClose = Primitive3.Close;
149
+
150
+ // src/popover-panel/style.ts
151
+ import { cn } from "@gridui/style-utils";
152
+ import { cva } from "class-variance-authority";
153
+ var menuPanelStyles = cva(cn(
154
+ "gridui-menu-panel",
155
+ "z-(--gridui-z-popover) box-border p-gridui-24 border border-solid border-border text-foreground bg-background type-supporting overflow-y-auto overscroll-contain w-3xl max-w-[min(calc(100vw-2*var(--gridui-page-gutter)),var(--radix-popover-content-available-width))] max-h-(--radix-popover-content-available-height) rounded-control",
156
+ "data-[state='closed']:pointer-events-none"
157
+ ));
158
+
159
+ // src/popover-panel/popover-panel.tsx
160
+ import { RetainedLayer } from "@gridui/overlay";
161
+ import { cn as cn2 } from "@gridui/style-utils";
162
+ import * as Primitive4 from "@radix-ui/react-popover";
163
+ import { useContext } from "react";
164
+ import { jsx as jsx2 } from "react/jsx-runtime";
165
+ var PopoverPanel = (props) => {
166
+ const {
167
+ className,
168
+ forceMount,
169
+ align = "start",
170
+ sideOffset = 8,
171
+ collisionPadding = 16,
172
+ onPointerEnter,
173
+ onPointerLeave,
174
+ onOpenAutoFocus,
175
+ onCloseAutoFocus,
176
+ onEscapeKeyDown,
177
+ ...restProps
178
+ } = props;
179
+ const interaction = useContext(Interaction);
180
+ const content = /* @__PURE__ */ jsx2(
181
+ Primitive4.Content,
182
+ {
183
+ ...restProps,
184
+ forceMount,
185
+ align,
186
+ sideOffset,
187
+ collisionPadding,
188
+ className: cn2(menuPanelStyles(), className),
189
+ onPointerEnter: (event) => {
190
+ onPointerEnter?.(event);
191
+ if (!event.defaultPrevented) {
192
+ interaction?.enter(event);
193
+ }
194
+ },
195
+ onPointerLeave: (event) => {
196
+ onPointerLeave?.(event);
197
+ if (!event.defaultPrevented) {
198
+ interaction?.leave(event);
199
+ }
200
+ },
201
+ onOpenAutoFocus: (event) => {
202
+ onOpenAutoFocus?.(event);
203
+ if (interaction?.hoverOpened.current) {
204
+ event.preventDefault();
205
+ }
206
+ },
207
+ onCloseAutoFocus: (event) => {
208
+ onCloseAutoFocus?.(event);
209
+ if (interaction?.hoverOpened.current) {
210
+ event.preventDefault();
211
+ }
212
+ },
213
+ onEscapeKeyDown: (event) => {
214
+ onEscapeKeyDown?.(event);
215
+ if (!event.defaultPrevented) {
216
+ interaction?.dismiss();
217
+ }
218
+ }
219
+ }
220
+ );
221
+ return /* @__PURE__ */ jsx2(
222
+ Primitive4.Portal,
223
+ {
224
+ forceMount,
225
+ children: forceMount ? /* @__PURE__ */ jsx2(RetainedLayer, { children: content }) : content
226
+ }
227
+ );
228
+ };
229
+
230
+ // src/popover-trigger/style.ts
231
+ import { cva as cva2 } from "class-variance-authority";
232
+ var popoverTriggerStyles = cva2("gridui-menu-trigger data-[state=open]:bg-surface");
233
+
234
+ // src/popover-trigger/popover-trigger.tsx
235
+ import { Button } from "@gridui/button";
236
+ import { cn as cn3 } from "@gridui/style-utils";
237
+ import * as Primitive5 from "@radix-ui/react-popover";
238
+ import { useContext as useContext2 } from "react";
239
+ import { jsx as jsx3 } from "react/jsx-runtime";
240
+ var PopoverTrigger = (props) => {
241
+ const {
242
+ size = "small",
243
+ className,
244
+ onPointerEnter,
245
+ onPointerLeave,
246
+ onPointerDown,
247
+ onKeyDown,
248
+ ...restProps
249
+ } = props;
250
+ const interaction = useContext2(Interaction);
251
+ const buttonProps = restProps.variant === void 0 ? {
252
+ ...restProps,
253
+ variant: "quiet"
254
+ } : restProps;
255
+ return /* @__PURE__ */ jsx3(
256
+ Primitive5.Trigger,
257
+ {
258
+ asChild: true,
259
+ children: /* @__PURE__ */ jsx3(
260
+ Button,
261
+ {
262
+ ...buttonProps,
263
+ size,
264
+ className: cn3(popoverTriggerStyles(), className),
265
+ onPointerEnter: (event) => {
266
+ onPointerEnter?.(event);
267
+ if (!restProps.disabled && !restProps.loading && !event.defaultPrevented) {
268
+ interaction?.enter(event);
269
+ }
270
+ },
271
+ onPointerLeave: (event) => {
272
+ onPointerLeave?.(event);
273
+ if (!event.defaultPrevented) {
274
+ interaction?.leave(event);
275
+ }
276
+ },
277
+ onPointerDown: (event) => {
278
+ onPointerDown?.(event);
279
+ if (!event.defaultPrevented) {
280
+ interaction?.activate();
281
+ }
282
+ },
283
+ onKeyDown: (event) => {
284
+ onKeyDown?.(event);
285
+ if (!event.defaultPrevented && (event.key === "Enter" || event.key === " ")) {
286
+ interaction?.activate();
287
+ }
288
+ }
289
+ }
290
+ )
291
+ }
292
+ );
293
+ };
294
+ export {
295
+ Popover,
296
+ PopoverAnchor,
297
+ PopoverClose,
298
+ PopoverPanel,
299
+ PopoverTrigger
300
+ };
301
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/shared/context.ts", "../src/popover/hover-intent.ts", "../src/popover/popover.tsx", "../src/popover-anchor/popover-anchor.tsx", "../src/popover-close/popover-close.tsx", "../src/popover-panel/style.ts", "../src/popover-panel/popover-panel.tsx", "../src/popover-trigger/style.ts", "../src/popover-trigger/popover-trigger.tsx"],
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Popover\n * @namespace Shared\n * @description Context\n */\n\nimport { createContext, type PointerEvent } from \"react\";\n\nexport type NavigationInteraction = {\n readonly hoverOpened: {\n current: boolean;\n };\n readonly enter: (event: PointerEvent<HTMLElement>) => void;\n readonly leave: (event: PointerEvent<HTMLElement>) => void;\n readonly activate: () => void;\n readonly dismiss: () => void;\n};\n\nexport const Interaction = createContext<NavigationInteraction | null>(null);\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace Popover\n * @description Hover Intent\n */\n\nexport const createHoverIntent = (open: () => void, close: () => void) => {\n let timer: ReturnType<typeof setTimeout> | undefined;\n let dismissed = false;\n const cancel = (): void => {\n clearTimeout(timer);\n timer = undefined;\n };\n return {\n enter(alreadyOpen: boolean): void {\n cancel();\n if (!dismissed && !alreadyOpen) {\n timer = setTimeout(open, 150);\n }\n },\n leave(shouldClose: boolean): void {\n cancel();\n dismissed = false;\n if (shouldClose) {\n timer = setTimeout(close, 250);\n }\n },\n dismiss(): void {\n cancel();\n dismissed = true;\n },\n cancel,\n };\n};\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace Popover\n * @description Popover\n */\n\nimport { Interaction, type NavigationInteraction } from \"../shared/context\";\nimport { createHoverIntent } from \"./hover-intent\";\nimport { OverlayOpen, useOverlayState } from \"@gridui/overlay\";\nimport * as Primitive from \"@radix-ui/react-popover\";\nimport { type ComponentPropsWithRef, type FC, useEffect, useMemo, useRef } from \"react\";\n\nexport type PopoverProps = ComponentPropsWithRef<typeof Primitive.Root> & {\n readonly hoverEnabled?: boolean;\n};\n\nexport const Popover: FC<PopoverProps> = (props: PopoverProps) => {\n const {\n open: controlledOpen,\n defaultOpen = false,\n onOpenChange,\n hoverEnabled = true,\n ...restProps\n } = props;\n const { open, onOpenChange: change } = useOverlayState({\n open: controlledOpen,\n defaultOpen,\n onOpenChange,\n });\n const hoverOpened = useRef(false);\n const openRef = useRef(open);\n const changeRef = useRef(change);\n const hoverTarget = useRef<HTMLElement | null>(null);\n useEffect(() => {\n openRef.current = open;\n changeRef.current = change;\n }, [\n open,\n change,\n ]);\n const intent = useMemo(() => {\n return createHoverIntent(() => {\n if (!hoverTarget.current?.isConnected || hoverTarget.current.matches(\":disabled, [aria-disabled='true']\")) {\n return;\n }\n hoverOpened.current = true;\n changeRef.current(true);\n }, () => {\n changeRef.current(false);\n });\n }, []);\n useEffect(() => {\n return intent.cancel;\n }, [intent]);\n useEffect(() => {\n if (!hoverEnabled) {\n intent.cancel();\n }\n }, [\n hoverEnabled,\n intent,\n ]);\n useEffect(() => {\n if (!open) {\n intent.cancel();\n }\n }, [\n intent,\n open,\n ]);\n const interaction: NavigationInteraction = {\n hoverOpened,\n enter(event) {\n if (hoverEnabled && event.pointerType === \"mouse\" && !event.currentTarget.matches(\":disabled, [aria-disabled='true']\")\n && window.matchMedia(\"(hover: hover) and (pointer: fine)\").matches) {\n hoverTarget.current = event.currentTarget;\n intent.enter(openRef.current);\n }\n },\n leave(event) {\n const focused = event.currentTarget.contains(document.activeElement);\n intent.leave(hoverOpened.current && !focused);\n },\n activate() {\n intent.cancel();\n hoverOpened.current = false;\n },\n dismiss() {\n intent.dismiss();\n hoverOpened.current = false;\n },\n };\n return (<Interaction.Provider\n value={interaction}\n >\n <OverlayOpen.Provider\n value={open}\n >\n <Primitive.Root\n {...restProps}\n open={open}\n onOpenChange={(next) => {\n if (!next) {\n interaction.dismiss();\n }\n change(next);\n }}\n />\n </OverlayOpen.Provider>\n </Interaction.Provider>);\n};\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace PopoverAnchor\n * @description Popover Anchor\n */\n\nimport * as Primitive from \"@radix-ui/react-popover\";\n\nexport const PopoverAnchor = Primitive.Anchor;\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace PopoverClose\n * @description Popover Close\n */\n\nimport * as Primitive from \"@radix-ui/react-popover\";\n\nexport const PopoverClose = Primitive.Close;\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace PopoverPanel\n * @description Style\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport { cva } from \"class-variance-authority\";\n\nexport const menuPanelStyles = cva(cn(\n \"gridui-menu-panel\",\n \"z-(--gridui-z-popover) box-border p-gridui-24 border border-solid border-border text-foreground bg-background type-supporting overflow-y-auto overscroll-contain w-3xl max-w-[min(calc(100vw-2*var(--gridui-page-gutter)),var(--radix-popover-content-available-width))] max-h-(--radix-popover-content-available-height) rounded-control\",\n \"data-[state='closed']:pointer-events-none\",\n));\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace PopoverPanel\n * @description Popover Panel\n */\n\nimport { Interaction } from \"../shared/context\";\nimport { menuPanelStyles } from \"./style\";\nimport { RetainedLayer } from \"@gridui/overlay\";\nimport { cn } from \"@gridui/style-utils\";\nimport * as Primitive from \"@radix-ui/react-popover\";\nimport { type ComponentPropsWithRef, type FC, useContext } from \"react\";\n\nexport type PopoverPanelProps = ComponentPropsWithRef<typeof Primitive.Content>;\n\nexport const PopoverPanel: FC<PopoverPanelProps> = (props: PopoverPanelProps) => {\n const {\n className,\n forceMount,\n align = \"start\",\n sideOffset = 8,\n collisionPadding = 16,\n onPointerEnter,\n onPointerLeave,\n onOpenAutoFocus,\n onCloseAutoFocus,\n onEscapeKeyDown,\n ...restProps\n } = props;\n const interaction = useContext(Interaction);\n const content = (<Primitive.Content\n {...restProps}\n forceMount={forceMount}\n align={align}\n sideOffset={sideOffset}\n collisionPadding={collisionPadding}\n className={cn(menuPanelStyles(), className)}\n onPointerEnter={(event) => {\n onPointerEnter?.(event);\n if (!event.defaultPrevented) {\n interaction?.enter(event);\n }\n }}\n onPointerLeave={(event) => {\n onPointerLeave?.(event);\n if (!event.defaultPrevented) {\n interaction?.leave(event);\n }\n }}\n onOpenAutoFocus={(event) => {\n onOpenAutoFocus?.(event);\n if (interaction?.hoverOpened.current) {\n event.preventDefault();\n }\n }}\n onCloseAutoFocus={(event) => {\n onCloseAutoFocus?.(event);\n if (interaction?.hoverOpened.current) {\n event.preventDefault();\n }\n }}\n onEscapeKeyDown={(event) => {\n onEscapeKeyDown?.(event);\n if (!event.defaultPrevented) {\n interaction?.dismiss();\n }\n }}\n />);\n return (<Primitive.Portal\n forceMount={forceMount}\n >\n {forceMount ? (<RetainedLayer>\n {content}\n </RetainedLayer>) : content}\n </Primitive.Portal>);\n};\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace PopoverTrigger\n * @description Style\n */\n\nimport { cva } from \"class-variance-authority\";\n\nexport const popoverTriggerStyles = cva(\"gridui-menu-trigger data-[state=open]:bg-surface\");\n", "/**\n * @author WMXPY\n * @package Popover\n * @namespace PopoverTrigger\n * @description Popover Trigger\n */\n\nimport { Interaction } from \"../shared/context\";\nimport { popoverTriggerStyles } from \"./style\";\nimport { Button, type ButtonProps } from \"@gridui/button\";\nimport { cn } from \"@gridui/style-utils\";\nimport * as Primitive from \"@radix-ui/react-popover\";\nimport { type FC, useContext } from \"react\";\n\nexport type PopoverTriggerProps = ButtonProps;\n\nexport const PopoverTrigger: FC<PopoverTriggerProps> = (props: PopoverTriggerProps) => {\n const {\n size = \"small\",\n className,\n onPointerEnter,\n onPointerLeave,\n onPointerDown,\n onKeyDown,\n ...restProps\n } = props;\n const interaction = useContext(Interaction);\n const buttonProps: ButtonProps = restProps.variant === undefined ? {\n ...restProps,\n variant: \"quiet\",\n } : restProps;\n return (<Primitive.Trigger\n asChild\n >\n <Button\n {...buttonProps}\n size={size}\n className={cn(popoverTriggerStyles(), className)}\n onPointerEnter={(event) => {\n onPointerEnter?.(event);\n if (!restProps.disabled\n && !restProps.loading\n && !event.defaultPrevented) {\n interaction?.enter(event);\n }\n }}\n onPointerLeave={(event) => {\n onPointerLeave?.(event);\n if (!event.defaultPrevented) {\n interaction?.leave(event);\n }\n }}\n onPointerDown={(event) => {\n onPointerDown?.(event);\n if (!event.defaultPrevented) {\n interaction?.activate();\n }\n }}\n onKeyDown={(event) => {\n onKeyDown?.(event);\n if (!event.defaultPrevented && (event.key === \"Enter\" || event.key === \" \")) {\n interaction?.activate();\n }\n }}\n />\n </Primitive.Trigger>);\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["Primitive", "Primitive", "cn", "Primitive", "jsx", "cva", "cn", "Primitive", "useContext", "jsx"]
7
+ }
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace Popover
5
+ * @description Hover Intent
6
+ */
7
+ export declare const createHoverIntent: (open: () => void, close: () => void) => {
8
+ enter(alreadyOpen: boolean): void;
9
+ leave(shouldClose: boolean): void;
10
+ dismiss(): void;
11
+ cancel: () => void;
12
+ };
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace Popover
5
+ * @description Popover
6
+ */
7
+ import * as Primitive from "@radix-ui/react-popover";
8
+ import { type ComponentPropsWithRef, type FC } from "react";
9
+ export type PopoverProps = ComponentPropsWithRef<typeof Primitive.Root> & {
10
+ readonly hoverEnabled?: boolean;
11
+ };
12
+ export declare const Popover: FC<PopoverProps>;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace PopoverAnchor
5
+ * @description Popover Anchor
6
+ */
7
+ import * as Primitive from "@radix-ui/react-popover";
8
+ export declare const PopoverAnchor: import("react").ForwardRefExoticComponent<Primitive.PopoverAnchorProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace PopoverClose
5
+ * @description Popover Close
6
+ */
7
+ import * as Primitive from "@radix-ui/react-popover";
8
+ export declare const PopoverClose: import("react").ForwardRefExoticComponent<Primitive.PopoverCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace PopoverPanel
5
+ * @description Popover Panel
6
+ */
7
+ import * as Primitive from "@radix-ui/react-popover";
8
+ import { type ComponentPropsWithRef, type FC } from "react";
9
+ export type PopoverPanelProps = ComponentPropsWithRef<typeof Primitive.Content>;
10
+ export declare const PopoverPanel: FC<PopoverPanelProps>;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace PopoverPanel
5
+ * @description Style
6
+ */
7
+ export declare const menuPanelStyles: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace PopoverTrigger
5
+ * @description Popover Trigger
6
+ */
7
+ import { type ButtonProps } from "@gridui/button";
8
+ import { type FC } from "react";
9
+ export type PopoverTriggerProps = ButtonProps;
10
+ export declare const PopoverTrigger: FC<PopoverTriggerProps>;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace PopoverTrigger
5
+ * @description Style
6
+ */
7
+ export declare const popoverTriggerStyles: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Popover
4
+ * @namespace Shared
5
+ * @description Context
6
+ */
7
+ import { type PointerEvent } from "react";
8
+ export type NavigationInteraction = {
9
+ readonly hoverOpened: {
10
+ current: boolean;
11
+ };
12
+ readonly enter: (event: PointerEvent<HTMLElement>) => void;
13
+ readonly leave: (event: PointerEvent<HTMLElement>) => void;
14
+ readonly activate: () => void;
15
+ readonly dismiss: () => void;
16
+ };
17
+ export declare const Interaction: import("react").Context<NavigationInteraction | null>;
@@ -0,0 +1,104 @@
1
+ /*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
2
+ @layer properties;
3
+ @layer theme, base, components, utilities;
4
+ @layer theme {
5
+ :root, :host {
6
+ --container-3xl: 48rem;
7
+ }
8
+ }
9
+ @layer utilities {
10
+ .z-\(--gridui-z-popover\) {
11
+ z-index: var(--gridui-z-popover);
12
+ }
13
+ .box-border {
14
+ box-sizing: border-box;
15
+ }
16
+ .max-h-\(--radix-popover-content-available-height\) {
17
+ max-height: var(--radix-popover-content-available-height);
18
+ }
19
+ .w-3xl {
20
+ width: var(--container-3xl);
21
+ }
22
+ .max-w-\[min\(calc\(100vw-2\*var\(--gridui-page-gutter\)\)\,var\(--radix-popover-content-available-width\)\)\] {
23
+ max-width: min(calc(100vw - 2 * var(--gridui-page-gutter)), var(--radix-popover-content-available-width));
24
+ }
25
+ .overflow-y-auto {
26
+ overflow-y: auto;
27
+ }
28
+ .overscroll-contain {
29
+ overscroll-behavior: contain;
30
+ }
31
+ .rounded-control {
32
+ border-radius: var(--gridui-control-radius);
33
+ }
34
+ .border {
35
+ border-style: var(--tw-border-style);
36
+ border-width: 1px;
37
+ }
38
+ .border-solid {
39
+ --tw-border-style: solid;
40
+ border-style: solid;
41
+ }
42
+ .border-border {
43
+ border-color: var(--gridui-border);
44
+ }
45
+ .bg-background {
46
+ background-color: var(--gridui-background);
47
+ }
48
+ .p-gridui-24 {
49
+ padding: var(--gridui-space-24);
50
+ }
51
+ .type-supporting {
52
+ font: var(--gridui-type-supporting);
53
+ letter-spacing: normal;
54
+ }
55
+ .text-foreground {
56
+ color: var(--gridui-foreground);
57
+ }
58
+ .data-\[state\=\'closed\'\]\:pointer-events-none[data-state='closed'] {
59
+ pointer-events: none;
60
+ }
61
+ .data-\[state\=open\]\:bg-surface[data-state="open"] {
62
+ background-color: var(--gridui-surface);
63
+ }
64
+ }
65
+ @layer components {
66
+ .gridui-menu-panel {
67
+ transform-origin: var(--radix-popover-content-transform-origin);
68
+ }
69
+ .gridui-menu-panel[data-side="bottom"] {
70
+ --gridui-surface-offset-y: calc(-1 * var(--gridui-motion-distance));
71
+ }
72
+ .gridui-menu-panel[data-side="top"] {
73
+ --gridui-surface-offset-y: var(--gridui-motion-distance);
74
+ }
75
+ .gridui-menu-panel[data-side="left"] {
76
+ --gridui-surface-offset-x: var(--gridui-motion-distance);
77
+ }
78
+ .gridui-menu-panel[data-side="right"] {
79
+ --gridui-surface-offset-x: calc(-1 * var(--gridui-motion-distance));
80
+ }
81
+ .gridui-menu-panel[data-state="open"] {
82
+ animation: gridui-surface-enter var(--gridui-motion-duration-normal) var(--gridui-motion-ease-out) both;
83
+ }
84
+ .gridui-menu-panel[data-state="closed"] {
85
+ animation: gridui-surface-exit var(--gridui-motion-duration-quick) var(--gridui-motion-ease-in) both;
86
+ }
87
+ @media (prefers-reduced-motion: reduce) {
88
+ .gridui-menu-panel[data-state] {
89
+ animation: none;
90
+ }
91
+ }
92
+ }
93
+ @property --tw-border-style {
94
+ syntax: "*";
95
+ inherits: false;
96
+ initial-value: solid;
97
+ }
98
+ @layer properties {
99
+ @supports ((-webkit-hyphens: none) and (not (margin-trim: inline))) or ((-moz-orient: inline) and (not (color:rgb(from red r g b)))) {
100
+ *, ::before, ::after, ::backdrop {
101
+ --tw-border-style: solid;
102
+ }
103
+ }
104
+ }
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@gridui/popover",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "1.0.0",
4
+ "description": "GridUI React popover",
5
+ "license": "UNLICENSED",
6
+ "type": "module",
7
+ "files": [
8
+ "dist",
9
+ "README.md"
10
+ ],
11
+ "sideEffects": [
12
+ "**/*.css"
13
+ ],
14
+ "exports": {
15
+ ".": {
16
+ "types": "./dist/index.d.ts",
17
+ "import": "./dist/index.js"
18
+ },
19
+ "./styles.css": "./dist/styles.css"
20
+ },
21
+ "publishConfig": {
22
+ "access": "public"
23
+ },
24
+ "peerDependencies": {
25
+ "react": "^19.2.0",
26
+ "react-dom": "^19.2.0"
27
+ },
28
+ "dependencies": {
29
+ "@gridui/button": "^2.1.1",
30
+ "@gridui/overlay": "^1.0.0",
31
+ "@gridui/style-utils": "^2.1.2",
32
+ "@gridui/theme": "^2.1.2",
33
+ "@radix-ui/react-popover": "1.3.1",
34
+ "class-variance-authority": "0.7.1"
35
+ },
36
+ "devDependencies": {
37
+ "@gridui-internal/configuration": "0.0.0",
38
+ "@jest/globals": "30.5.2",
39
+ "@types/jest": "30.0.0",
40
+ "@types/node": "26.6.5",
41
+ "@types/react": "19.3.0",
42
+ "@types/react-dom": "19.3.0",
43
+ "jest": "30.5.2",
44
+ "react": "19.3.1",
45
+ "react-dom": "19.3.1",
46
+ "typescript": "6.0.3"
47
+ },
48
+ "scripts": {
49
+ "build": "node ../../scripts/compilation/package.ts",
50
+ "compile": "tsc --project tsconfig.json",
51
+ "test": "jest",
52
+ "coverage": "jest --coverage"
53
+ }
6
54
  }