@gridui/toast 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/toast
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: `ToastAction`, `ToastOptions`, `ToastProvider`, `ToastProviderProps`, `ToastTone`, `ToastUpdate`, `Toaster`, `ToasterProps`, `useToast`.
4
+
5
+ Import components from `@gridui/toast` and load `@gridui/toast/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,15 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Root
5
+ * @description Index
6
+ */
7
+ export type { ToastAction } from "./shared/types";
8
+ export type { ToastOptions } from "./shared/types";
9
+ export type { ToastTone } from "./shared/types";
10
+ export type { ToastUpdate } from "./shared/types";
11
+ export type { ToastProviderProps } from "./toast-provider/toast-provider";
12
+ export { ToastProvider } from "./toast-provider/toast-provider";
13
+ export type { ToasterProps } from "./toaster/toaster";
14
+ export { Toaster } from "./toaster/toaster";
15
+ export { useToast } from "./toaster/use-toast";
package/dist/index.js ADDED
@@ -0,0 +1,316 @@
1
+ // src/shared/context.ts
2
+ import { createContext } from "react";
3
+ var ToastCommands = createContext(null);
4
+ var ToastStateContext = createContext(null);
5
+
6
+ // src/toast-provider/model.ts
7
+ var toastOptions = (options) => {
8
+ if (options.timeout !== void 0 && (!Number.isFinite(options.timeout) || options.timeout < 0)) {
9
+ throw new RangeError("Toast timeout must be a finite non-negative number.");
10
+ }
11
+ return options;
12
+ };
13
+
14
+ // src/toast-provider/toast-provider.tsx
15
+ import { useCallback, useId, useMemo, useRef, useState } from "react";
16
+ import { jsx } from "react/jsx-runtime";
17
+ var ToastProvider = (props) => {
18
+ const { children, timeout = 5e3, limit = 3 } = props;
19
+ if (!Number.isFinite(timeout) || timeout < 0 || !Number.isInteger(limit) || limit < 1) {
20
+ throw new RangeError("ToastProvider needs a non-negative timeout and a positive integer limit.");
21
+ }
22
+ const [
23
+ records,
24
+ setRecords
25
+ ] = useState([]);
26
+ const current = useRef(records);
27
+ const sequence = useRef(0);
28
+ const prefix = useId();
29
+ const publish = useCallback((next) => {
30
+ current.current = next;
31
+ setRecords(next);
32
+ }, []);
33
+ const add = useCallback((options) => {
34
+ toastOptions(options);
35
+ const id = options.id ?? `${prefix}-${++sequence.current}`;
36
+ const replaced = current.current.find((record) => {
37
+ return record.id === id;
38
+ });
39
+ const others = current.current.filter((record) => {
40
+ return record.open && record.id !== id;
41
+ });
42
+ const evicted = others.slice(0, Math.max(0, others.length - limit + 1));
43
+ publish([
44
+ ...others.slice(Math.max(0, others.length - limit + 1)),
45
+ {
46
+ ...options,
47
+ id,
48
+ open: true,
49
+ revision: (replaced?.revision ?? 0) + 1
50
+ }
51
+ ]);
52
+ evicted.forEach((record) => {
53
+ record.onClose?.();
54
+ });
55
+ return id;
56
+ }, [
57
+ prefix,
58
+ limit,
59
+ publish
60
+ ]);
61
+ const update = useCallback((id, options) => {
62
+ toastOptions(options);
63
+ if (!current.current.some((record) => {
64
+ return record.id === id && record.open;
65
+ })) {
66
+ return;
67
+ }
68
+ publish(current.current.map((record) => {
69
+ return record.id === id && record.open ? {
70
+ ...record,
71
+ ...options,
72
+ revision: record.revision + 1
73
+ } : record;
74
+ }));
75
+ }, [publish]);
76
+ const close = useCallback((id) => {
77
+ const closing = current.current.filter((record) => {
78
+ return record.open && (id === void 0 || record.id === id);
79
+ });
80
+ if (closing.length === 0) {
81
+ return;
82
+ }
83
+ publish(current.current.map((record) => {
84
+ return closing.includes(record) ? {
85
+ ...record,
86
+ open: false
87
+ } : record;
88
+ }));
89
+ closing.forEach((record) => {
90
+ record.onClose?.();
91
+ });
92
+ }, [publish]);
93
+ const remove = useCallback((id, revision) => {
94
+ const next = current.current.filter((record) => {
95
+ return record.id !== id || record.revision !== revision || record.open;
96
+ });
97
+ if (next.length !== current.current.length) {
98
+ publish(next);
99
+ }
100
+ }, [publish]);
101
+ const manager = useMemo(() => {
102
+ return {
103
+ add,
104
+ update,
105
+ close
106
+ };
107
+ }, [
108
+ add,
109
+ update,
110
+ close
111
+ ]);
112
+ return /* @__PURE__ */ jsx(
113
+ ToastCommands.Provider,
114
+ {
115
+ value: manager,
116
+ children: /* @__PURE__ */ jsx(
117
+ ToastStateContext.Provider,
118
+ {
119
+ value: {
120
+ records,
121
+ timeout,
122
+ remove
123
+ },
124
+ children
125
+ }
126
+ )
127
+ }
128
+ );
129
+ };
130
+
131
+ // src/toaster/context.ts
132
+ import { useContext } from "react";
133
+ var useToastState = () => {
134
+ const state = useContext(ToastStateContext);
135
+ if (!state) {
136
+ throw new Error("Toasts require a ToastProvider parent.");
137
+ }
138
+ return state;
139
+ };
140
+
141
+ // src/toaster/use-toast.ts
142
+ import { useContext as useContext2 } from "react";
143
+ var useToast = () => {
144
+ const manager = useContext2(ToastCommands);
145
+ if (!manager) {
146
+ throw new Error("Toasts require a ToastProvider parent.");
147
+ }
148
+ return manager;
149
+ };
150
+
151
+ // src/toaster/toast-item.tsx
152
+ import { Button } from "@gridui/button";
153
+ import * as Primitive from "@radix-ui/react-toast";
154
+ import { X } from "lucide-react";
155
+ import { useCallback as useCallback2 } from "react";
156
+ import { jsx as jsx2, jsxs } from "react/jsx-runtime";
157
+ var ToastItem = (props) => {
158
+ const { record, closeLabel } = props;
159
+ const { close } = useToast();
160
+ const { remove, timeout } = useToastState();
161
+ const ref = useCallback2((node) => {
162
+ if (!node) {
163
+ queueMicrotask(() => {
164
+ remove(record.id, record.revision);
165
+ });
166
+ }
167
+ }, [
168
+ remove,
169
+ record.id,
170
+ record.revision
171
+ ]);
172
+ const duration = record.timeout ?? timeout;
173
+ return /* @__PURE__ */ jsx2(
174
+ Primitive.Root,
175
+ {
176
+ ref,
177
+ open: record.open,
178
+ onOpenChange: (open) => {
179
+ if (!open) {
180
+ close(record.id);
181
+ }
182
+ },
183
+ duration: duration === 0 ? Infinity : duration,
184
+ type: record.priority === "high" ? "foreground" : "background",
185
+ className: "gridui-toast",
186
+ "data-tone": record.tone ?? "neutral",
187
+ inert: !record.open,
188
+ children: /* @__PURE__ */ jsxs(
189
+ "div",
190
+ {
191
+ className: "gridui-toast-content",
192
+ children: [
193
+ /* @__PURE__ */ jsxs(
194
+ "div",
195
+ {
196
+ className: "gridui-toast-message",
197
+ children: [
198
+ /* @__PURE__ */ jsx2(
199
+ Primitive.Title,
200
+ {
201
+ className: "gridui-toast-title",
202
+ children: record.title
203
+ }
204
+ ),
205
+ record.description && /* @__PURE__ */ jsx2(
206
+ Primitive.Description,
207
+ {
208
+ className: "gridui-toast-description",
209
+ children: record.description
210
+ }
211
+ )
212
+ ]
213
+ }
214
+ ),
215
+ record.action && /* @__PURE__ */ jsx2(
216
+ Primitive.Action,
217
+ {
218
+ asChild: true,
219
+ altText: record.action.altText,
220
+ children: /* @__PURE__ */ jsx2(
221
+ Button,
222
+ {
223
+ variant: "secondary",
224
+ className: "gridui-toast-action",
225
+ size: "small",
226
+ disabled: record.action.disabled,
227
+ onClick: record.action.onClick,
228
+ children: record.action.label
229
+ }
230
+ )
231
+ }
232
+ ),
233
+ /* @__PURE__ */ jsx2(
234
+ Primitive.Close,
235
+ {
236
+ asChild: true,
237
+ "aria-label": closeLabel,
238
+ children: /* @__PURE__ */ jsx2(
239
+ Button,
240
+ {
241
+ variant: "quiet",
242
+ className: "gridui-toast-close",
243
+ layout: "icon",
244
+ size: "small",
245
+ children: /* @__PURE__ */ jsx2(
246
+ X,
247
+ {
248
+ "aria-hidden": "true"
249
+ }
250
+ )
251
+ }
252
+ )
253
+ }
254
+ )
255
+ ]
256
+ }
257
+ )
258
+ }
259
+ );
260
+ };
261
+
262
+ // src/toaster/toaster.tsx
263
+ import { cn } from "@gridui/style-utils";
264
+ import * as Primitive2 from "@radix-ui/react-toast";
265
+ import { useEffect, useState as useState2 } from "react";
266
+ import { createPortal } from "react-dom";
267
+ import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
268
+ var Toaster = (props) => {
269
+ const { label, closeLabel, container, className, ...restProps } = props;
270
+ const { records, timeout } = useToastState();
271
+ const [
272
+ mounted,
273
+ setMounted
274
+ ] = useState2(false);
275
+ useEffect(() => {
276
+ setMounted(true);
277
+ }, []);
278
+ if (!mounted) {
279
+ return null;
280
+ }
281
+ return createPortal(/* @__PURE__ */ jsxs2(
282
+ Primitive2.Provider,
283
+ {
284
+ label,
285
+ duration: timeout === 0 ? Infinity : timeout,
286
+ swipeDirection: "down",
287
+ announcerContainer: container,
288
+ children: [
289
+ records.map((record) => {
290
+ return /* @__PURE__ */ jsx3(
291
+ ToastItem,
292
+ {
293
+ record,
294
+ closeLabel
295
+ },
296
+ `${record.id}:${record.revision}`
297
+ );
298
+ }),
299
+ /* @__PURE__ */ jsx3(
300
+ Primitive2.Viewport,
301
+ {
302
+ ...restProps,
303
+ label,
304
+ className: cn("gridui-toast-viewport", className)
305
+ }
306
+ )
307
+ ]
308
+ }
309
+ ), container ?? document.body);
310
+ };
311
+ export {
312
+ ToastProvider,
313
+ Toaster,
314
+ useToast
315
+ };
316
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/shared/context.ts", "../src/toast-provider/model.ts", "../src/toast-provider/toast-provider.tsx", "../src/toaster/context.ts", "../src/toaster/use-toast.ts", "../src/toaster/toast-item.tsx", "../src/toaster/toaster.tsx"],
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Toast\n * @namespace Shared\n * @description Context\n */\n\nimport type { ToastManager, ToastRecord } from \"./types\";\nimport { createContext } from \"react\";\n\nexport type ToastState = {\n readonly records: readonly ToastRecord[];\n readonly timeout: number;\n readonly remove: (id: string, revision: number) => void;\n};\n\nexport const ToastCommands = createContext<ToastManager | null>(null);\n\nexport const ToastStateContext = createContext<ToastState | null>(null);\n", "/**\n * @author WMXPY\n * @package Toast\n * @namespace ToastProvider\n * @description Model\n */\n\nimport type { ToastUpdate } from \"../shared/types\";\n\nexport const toastOptions = (options: ToastUpdate): ToastUpdate => {\n if (options.timeout !== undefined && (!Number.isFinite(options.timeout) || options.timeout < 0)) {\n throw new RangeError(\"Toast timeout must be a finite non-negative number.\");\n }\n return options;\n};\n", "/**\n * @author WMXPY\n * @package Toast\n * @namespace ToastProvider\n * @description Toast Provider\n */\n\nimport { ToastCommands, ToastStateContext } from \"../shared/context\";\nimport type { ToastOptions, ToastRecord, ToastUpdate } from \"../shared/types\";\nimport { toastOptions } from \"./model\";\nimport { type FC, type ReactNode, useCallback, useId, useMemo, useRef, useState } from \"react\";\n\nexport type ToastProviderProps = {\n readonly children?: ReactNode;\n readonly timeout?: number;\n readonly limit?: number;\n};\n\nexport const ToastProvider: FC<ToastProviderProps> = (props: ToastProviderProps) => {\n const { children, timeout = 5000, limit = 3 } = props;\n if (!Number.isFinite(timeout) || timeout < 0 || !Number.isInteger(limit) || limit < 1) {\n throw new RangeError(\"ToastProvider needs a non-negative timeout and a positive integer limit.\");\n }\n const [\n records,\n setRecords,\n ] = useState<readonly ToastRecord[]>([]);\n const current = useRef(records);\n const sequence = useRef(0);\n const prefix = useId();\n const publish = useCallback((next: readonly ToastRecord[]) => {\n current.current = next;\n setRecords(next);\n }, []);\n const add = useCallback((options: ToastOptions): string => {\n toastOptions(options);\n const id = options.id ?? `${prefix}-${++sequence.current}`;\n const replaced = current.current.find(record => {\n return record.id === id;\n });\n const others = current.current.filter(record => {\n return record.open && record.id !== id;\n });\n const evicted = others.slice(0, Math.max(0, others.length - limit + 1));\n publish([\n ...others.slice(Math.max(0, others.length - limit + 1)),\n {\n ...options,\n id,\n open: true,\n revision: (replaced?.revision ?? 0) + 1,\n },\n ]);\n evicted.forEach(record => {\n record.onClose?.();\n });\n return id;\n }, [\n prefix,\n limit,\n publish,\n ]);\n const update = useCallback((id: string, options: ToastUpdate) => {\n toastOptions(options);\n if (!current.current.some(record => {\n return record.id === id && record.open;\n })) {\n return;\n }\n publish(current.current.map(record => {\n return record.id === id && record.open ? {\n ...record,\n ...options,\n revision: record.revision + 1,\n } : record;\n }));\n }, [publish]);\n const close = useCallback((id?: string) => {\n const closing = current.current.filter(record => {\n return record.open && (id === undefined || record.id === id);\n });\n if (closing.length === 0) {\n return;\n }\n publish(current.current.map(record => {\n return closing.includes(record) ? {\n ...record,\n open: false,\n } : record;\n }));\n closing.forEach(record => {\n record.onClose?.();\n });\n }, [publish]);\n const remove = useCallback((id: string, revision: number) => {\n const next = current.current.filter(record => {\n return record.id !== id || record.revision !== revision || record.open;\n });\n if (next.length !== current.current.length) {\n publish(next);\n }\n }, [publish]);\n const manager = useMemo(() => {\n return {\n add,\n update,\n close,\n };\n }, [\n add,\n update,\n close,\n ]);\n return (<ToastCommands.Provider\n value={manager}\n >\n <ToastStateContext.Provider\n value={{\n records,\n timeout,\n remove,\n }}\n >\n {children}\n </ToastStateContext.Provider>\n </ToastCommands.Provider>);\n};\n", "/**\n * @author WMXPY\n * @package Toast\n * @namespace Toaster\n * @description Context\n */\n\nimport { type ToastState, ToastStateContext } from \"../shared/context\";\nimport { useContext } from \"react\";\n\nexport const useToastState = (): ToastState => {\n const state = useContext(ToastStateContext);\n if (!state) {\n throw new Error(\"Toasts require a ToastProvider parent.\");\n }\n return state;\n};\n", "/**\n * @author WMXPY\n * @package Toast\n * @namespace Toaster\n * @description Use Toast\n */\n\nimport { ToastCommands } from \"../shared/context\";\nimport type { ToastManager } from \"../shared/types\";\nimport { useContext } from \"react\";\n\nexport const useToast = (): ToastManager => {\n const manager = useContext(ToastCommands);\n if (!manager) {\n throw new Error(\"Toasts require a ToastProvider parent.\");\n }\n return manager;\n};\n", "/**\n * @author WMXPY\n * @package Toast\n * @namespace Toaster\n * @description Toast Item\n */\n\nimport type { ToastRecord } from \"../shared/types\";\nimport { useToastState } from \"./context\";\nimport { useToast } from \"./use-toast\";\nimport { Button } from \"@gridui/button\";\nimport * as Primitive from \"@radix-ui/react-toast\";\nimport { X } from \"lucide-react\";\nimport { type FC, useCallback } from \"react\";\n\nexport type ToastItemProps = {\n readonly record: ToastRecord;\n readonly closeLabel: string;\n};\n\nexport const ToastItem: FC<ToastItemProps> = (props: ToastItemProps) => {\n const { record, closeLabel } = props;\n const { close } = useToast();\n const { remove, timeout } = useToastState();\n const ref = useCallback((node: HTMLLIElement | null) => {\n if (!node) {\n queueMicrotask(() => {\n remove(record.id, record.revision);\n });\n }\n }, [\n remove,\n record.id,\n record.revision,\n ]);\n const duration = record.timeout ?? timeout;\n return (<Primitive.Root\n ref={ref}\n open={record.open}\n onOpenChange={(open) => {\n if (!open) {\n close(record.id);\n }\n }}\n duration={duration === 0 ? Infinity : duration}\n type={record.priority === \"high\" ? \"foreground\" : \"background\"}\n className=\"gridui-toast\"\n data-tone={record.tone ?? \"neutral\"}\n inert={!record.open}\n >\n <div\n className=\"gridui-toast-content\"\n >\n <div\n className=\"gridui-toast-message\"\n >\n <Primitive.Title\n className=\"gridui-toast-title\"\n >\n {record.title}\n </Primitive.Title>\n {record.description && (<Primitive.Description\n className=\"gridui-toast-description\"\n >\n {record.description}\n </Primitive.Description>)}\n </div>\n {record.action && (<Primitive.Action\n asChild\n altText={record.action.altText}\n >\n <Button\n variant=\"secondary\"\n className=\"gridui-toast-action\"\n size=\"small\"\n disabled={record.action.disabled}\n onClick={record.action.onClick}\n >\n {record.action.label}\n </Button>\n </Primitive.Action>)}\n <Primitive.Close\n asChild\n aria-label={closeLabel}\n >\n <Button\n variant=\"quiet\"\n className=\"gridui-toast-close\"\n layout=\"icon\"\n size=\"small\"\n >\n <X\n aria-hidden=\"true\"\n />\n </Button>\n </Primitive.Close>\n </div>\n </Primitive.Root>);\n};\n", "/**\n * @author WMXPY\n * @package Toast\n * @namespace Toaster\n * @description Toaster\n */\n\nimport { useToastState } from \"./context\";\nimport { ToastItem } from \"./toast-item\";\nimport { cn } from \"@gridui/style-utils\";\nimport * as Primitive from \"@radix-ui/react-toast\";\nimport { type ComponentPropsWithRef, type FC, useEffect, useState } from \"react\";\nimport { createPortal } from \"react-dom\";\n\nexport type ToasterProps = Omit<ComponentPropsWithRef<\"ol\">, \"children\" | \"aria-label\"> & {\n readonly label: string;\n readonly closeLabel: string;\n readonly container?: HTMLElement | undefined;\n};\n\nexport const Toaster: FC<ToasterProps> = (props: ToasterProps) => {\n const { label, closeLabel, container, className, ...restProps } = props;\n const { records, timeout } = useToastState();\n const [\n mounted,\n setMounted,\n ] = useState(false);\n useEffect(() => {\n setMounted(true);\n }, []);\n if (!mounted) {\n return null;\n }\n return createPortal((<Primitive.Provider\n label={label}\n duration={timeout === 0 ? Infinity : timeout}\n swipeDirection=\"down\"\n announcerContainer={container}\n >\n {records.map(record => {\n return (<ToastItem\n key={`${record.id}:${record.revision}`}\n record={record}\n closeLabel={closeLabel}\n />);\n })}\n <Primitive.Viewport\n {...restProps}\n label={label}\n className={cn(\"gridui-toast-viewport\", className)}\n />\n </Primitive.Provider>), container ?? document.body);\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["useContext", "useCallback", "jsx", "Primitive", "useState", "jsx", "jsxs"]
7
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Shared
5
+ * @description Context
6
+ */
7
+ import type { ToastManager, ToastRecord } from "./types";
8
+ export type ToastState = {
9
+ readonly records: readonly ToastRecord[];
10
+ readonly timeout: number;
11
+ readonly remove: (id: string, revision: number) => void;
12
+ };
13
+ export declare const ToastCommands: import("react").Context<ToastManager | null>;
14
+ export declare const ToastStateContext: import("react").Context<ToastState | null>;
@@ -0,0 +1,35 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Shared
5
+ * @description Types
6
+ */
7
+ import type { MouseEventHandler, ReactNode } from "react";
8
+ export type ToastTone = "neutral" | "success" | "warning" | "danger";
9
+ export type ToastAction = {
10
+ readonly label: string;
11
+ readonly altText: string;
12
+ readonly onClick: MouseEventHandler<HTMLButtonElement>;
13
+ readonly disabled?: boolean;
14
+ };
15
+ export type ToastOptions = {
16
+ readonly id?: string;
17
+ readonly title: ReactNode;
18
+ readonly description?: ReactNode;
19
+ readonly tone?: ToastTone;
20
+ readonly timeout?: number;
21
+ readonly priority?: "low" | "high";
22
+ readonly action?: ToastAction | null;
23
+ readonly onClose?: () => void;
24
+ };
25
+ export type ToastUpdate = Partial<Omit<ToastOptions, "id">>;
26
+ export type ToastRecord = ToastOptions & {
27
+ readonly id: string;
28
+ readonly revision: number;
29
+ readonly open: boolean;
30
+ };
31
+ export type ToastManager = {
32
+ readonly add: (options: ToastOptions) => string;
33
+ readonly update: (id: string, options: ToastUpdate) => void;
34
+ readonly close: (id?: string) => void;
35
+ };
@@ -0,0 +1,105 @@
1
+ /*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
2
+ @layer theme, base, components, utilities;
3
+ @layer utilities {
4
+ .container {
5
+ width: 100%;
6
+ @media (width >= 40rem) {
7
+ max-width: 40rem;
8
+ }
9
+ @media (width >= 48rem) {
10
+ max-width: 48rem;
11
+ }
12
+ @media (width >= 64rem) {
13
+ max-width: 64rem;
14
+ }
15
+ @media (width >= 80rem) {
16
+ max-width: 80rem;
17
+ }
18
+ @media (width >= 96rem) {
19
+ max-width: 96rem;
20
+ }
21
+ }
22
+ }
23
+ @layer components {
24
+ .gridui-toast-viewport {
25
+ padding: 0;
26
+ margin: 0;
27
+ list-style: none;
28
+ position: fixed;
29
+ z-index: var(--gridui-z-toast);
30
+ inset-inline-end: max(var(--gridui-space-16), env(safe-area-inset-right));
31
+ bottom: max(var(--gridui-space-16), env(safe-area-inset-bottom));
32
+ display: flex;
33
+ flex-direction: column-reverse;
34
+ gap: var(--gridui-space-8);
35
+ width: min(26rem, calc(100% - 2 * var(--gridui-space-16)));
36
+ max-height: calc(100dvh - 2 * var(--gridui-space-16));
37
+ overflow: auto;
38
+ pointer-events: none;
39
+ }
40
+ .gridui-toast {
41
+ flex-shrink: 0;
42
+ border: 1px solid var(--gridui-border);
43
+ background: var(--gridui-background);
44
+ color: var(--gridui-foreground);
45
+ font: var(--gridui-type-supporting);
46
+ letter-spacing: normal;
47
+ pointer-events: auto;
48
+ }
49
+ .gridui-toast[data-state="open"] {
50
+ animation: gridui-surface-enter var(--gridui-motion-duration-normal) var(--gridui-motion-ease-out);
51
+ }
52
+ .gridui-toast[data-state="closed"] {
53
+ pointer-events: none;
54
+ animation: gridui-surface-exit var(--gridui-motion-duration-quick) var(--gridui-motion-ease-in);
55
+ }
56
+ .gridui-toast[data-swipe="move"] {
57
+ transform: translateY(var(--radix-toast-swipe-move-y));
58
+ }
59
+ .gridui-toast[data-swipe="cancel"] {
60
+ transform: translateY(0);
61
+ transition: transform var(--gridui-motion-duration-quick) var(--gridui-motion-ease-out);
62
+ }
63
+ .gridui-toast[data-tone="success"] {
64
+ border-inline-start: 4px solid var(--gridui-accent-background);
65
+ }
66
+ .gridui-toast[data-tone="warning"] {
67
+ border-inline-start: 4px solid var(--gridui-warning-foreground);
68
+ }
69
+ .gridui-toast[data-tone="danger"] {
70
+ border-inline-start: 4px solid var(--gridui-danger-foreground);
71
+ }
72
+ .gridui-toast-content {
73
+ display: grid;
74
+ grid-template-columns: minmax(0, 1fr) auto auto;
75
+ align-items: center;
76
+ gap: var(--gridui-space-8);
77
+ padding: var(--gridui-space-16);
78
+ }
79
+ .gridui-toast-message {
80
+ min-width: 0;
81
+ overflow-wrap: anywhere;
82
+ }
83
+ .gridui-toast-close {
84
+ grid-column: 3;
85
+ }
86
+ .gridui-toast-action {
87
+ max-width: 8rem;
88
+ overflow-wrap: anywhere;
89
+ }
90
+ .gridui-toast-title {
91
+ font: var(--gridui-type-ui);
92
+ letter-spacing: normal;
93
+ }
94
+ .gridui-toast-description {
95
+ font: var(--gridui-type-supporting);
96
+ letter-spacing: normal;
97
+ color: var(--gridui-muted);
98
+ }
99
+ @media (prefers-reduced-motion: reduce) {
100
+ .gridui-toast[data-state] {
101
+ animation: none;
102
+ transition: none;
103
+ }
104
+ }
105
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace ToastProvider
5
+ * @description Model
6
+ */
7
+ import type { ToastUpdate } from "../shared/types";
8
+ export declare const toastOptions: (options: ToastUpdate) => ToastUpdate;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace ToastProvider
5
+ * @description Toast Provider
6
+ */
7
+ import { type FC, type ReactNode } from "react";
8
+ export type ToastProviderProps = {
9
+ readonly children?: ReactNode;
10
+ readonly timeout?: number;
11
+ readonly limit?: number;
12
+ };
13
+ export declare const ToastProvider: FC<ToastProviderProps>;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Toaster
5
+ * @description Context
6
+ */
7
+ import { type ToastState } from "../shared/context";
8
+ export declare const useToastState: () => ToastState;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Toaster
5
+ * @description Toast Item
6
+ */
7
+ import type { ToastRecord } from "../shared/types";
8
+ import { type FC } from "react";
9
+ export type ToastItemProps = {
10
+ readonly record: ToastRecord;
11
+ readonly closeLabel: string;
12
+ };
13
+ export declare const ToastItem: FC<ToastItemProps>;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Toaster
5
+ * @description Toaster
6
+ */
7
+ import { type ComponentPropsWithRef, type FC } from "react";
8
+ export type ToasterProps = Omit<ComponentPropsWithRef<"ol">, "children" | "aria-label"> & {
9
+ readonly label: string;
10
+ readonly closeLabel: string;
11
+ readonly container?: HTMLElement | undefined;
12
+ };
13
+ export declare const Toaster: FC<ToasterProps>;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Toast
4
+ * @namespace Toaster
5
+ * @description Use Toast
6
+ */
7
+ import type { ToastManager } from "../shared/types";
8
+ export declare const useToast: () => ToastManager;
package/package.json CHANGED
@@ -1,6 +1,53 @@
1
1
  {
2
2
  "name": "@gridui/toast",
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 toast",
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/style-utils": "^2.1.2",
31
+ "@gridui/theme": "^2.1.2",
32
+ "@radix-ui/react-toast": "1.3.1",
33
+ "lucide-react": "1.62.0"
34
+ },
35
+ "devDependencies": {
36
+ "@gridui-internal/configuration": "0.0.0",
37
+ "@jest/globals": "30.5.2",
38
+ "@types/jest": "30.0.0",
39
+ "@types/node": "26.6.5",
40
+ "@types/react": "19.3.0",
41
+ "@types/react-dom": "19.3.0",
42
+ "jest": "30.5.2",
43
+ "react": "19.3.1",
44
+ "react-dom": "19.3.1",
45
+ "typescript": "6.0.3"
46
+ },
47
+ "scripts": {
48
+ "build": "node ../../scripts/compilation/package.ts",
49
+ "compile": "tsc --project tsconfig.json",
50
+ "test": "jest",
51
+ "coverage": "jest --coverage"
52
+ }
6
53
  }