@solid2-aria/sonner 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pekochan069
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.txt

@@ -0,0 +1,27 @@
+Solid2 Sonner third-party notices
+================================
+
+The source files in src/ are derived from solid-sonner:
+https://github.com/wobsoriano/solid-sonner (src/index.tsx, src/assets.tsx,
+src/state.ts, src/types.ts, src/primitives.ts, and src/styles.css).
+Copyright (c) 2022 Robert Soriano <https://github.com/wobsoriano>
+The upstream MIT license is reproduced verbatim in SOLID-SONNER-LICENSE.md.
+
+solid-sonner is based on Sonner:
+https://github.com/emilkowalski/sonner (src/index.tsx, src/assets.tsx,
+src/state.ts, src/types.ts, and src/styles.css).
+Copyright (c) 2023 Emil Kowalski
+The upstream MIT license is reproduced verbatim in SONNER-LICENSE.md.
+The original Sonner attribution comment is retained in src/index.tsx.
+
+Modified for Solid Aria: Solid 2 renderer imports, reactive props, signals,
+stores, compute/apply effects, lifecycle cleanup, native DOM events, promise
+handling, dismissal and history management, and browser/server packaging.
+Styles are exported as a separate CSS entry point. Each derived source file
+identifies its upstream path and modifications. Upstream source notices and
+license texts were compared with upstream main during package integration.
+
+Tests, build configuration, and package verification scripts are independently
+written. Solid Aria contributions use the MIT license in LICENSE, Copyright
+(c) 2026 pekochan069. This license does not replace the upstream licenses and
+notices. This package introduces no Adobe-derived code or JSON translations.

package/README.md

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# Solid 2 Sonner
 
-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.
+Toast notifications for Solid 2, adapted from solid-sonner and Sonner. Requires `solid-js` and `@solidjs/web` 2.0.0-rc.17 or later in the Solid 2 release line.
+
+In a workspace app, add the dependency and build the package from the repository root:
+
+```sh
+bun add --cwd apps/your-app @solid2-aria/sonner@^0.0.1
+bun run --filter @solid2-aria/sonner build
+```
+
+Import the stylesheet once in your app entry point, and mount a `Toaster`:
+
+```tsx
+import { Toaster, toast } from "@solid2-aria/sonner";
+
+import "@solid2-aria/sonner/styles.css";
+
+export default function App() {
+  return (
+    <>
+      <button onClick={() => toast.success("Saved")}>Save</button>
+      <Toaster theme="system" richColors closeButton />
+    </>
+  );
+}
+```
+
+Mount one default toaster per application. To route notifications to another toaster, use `<Toaster id="editor" />` with `toast("Saved", { toasterId: "editor" })`.
+
+The package exports `Toaster`, `toast`, `useSonner`, and public types including `ToasterProps`, `ExternalToast`, and `PromiseData`. It supports actions, six positions, swipe dismissal, paused timers, custom icons, and style overrides.
+
+Update or dismiss an existing toast with its ID:
+
+```tsx
+const id = toast.loading("Saving");
+toast.success("Saved", { id });
+toast.dismiss(id);
+
+toast.promise(saveChanges(), {
+  loading: "Saving",
+  success: "Saved",
+  error: "Could not save",
+});
+
+toast.custom((id) => (
+  <button onClick={() => toast.dismiss(id)}>Dismiss</button>
+));
+```
+
+Call `useSonner()` inside a Solid owner to observe active toasts through `toasts()`:
+
+```tsx
+import { useSonner } from "@solid2-aria/sonner";
+
+function NotificationCount() {
+  const { toasts } = useSonner();
+  return <span>{toasts().length} notifications</span>;
+}
+```
+
+The export selects compiled browser code for browser bundles and SSR code for server bundles. SSR and hydration are checked with Solid's rendering APIs. Toast state is module scoped, so call `toast()` from client interactions rather than request-scoped server code.
+
+Run verification from `packages/sonner`:
+
+```sh
+bun run build
+bun run check-types
+bun test
+bun run check-build
+bun run check
+```
+
+`check-build` copies shipped files into a temporary consumer and checks exports, CSS, types, SSR, DOM hydration, and toast interactions. DOM checks use Happy DOM.
+
+Solid Aria contributions use the [MIT license](./LICENSE). The original MIT licenses are in [SOLID-SONNER-LICENSE.md](./SOLID-SONNER-LICENSE.md) for solid-sonner and [SONNER-LICENSE.md](./SONNER-LICENSE.md) for Sonner. [NOTICE.txt](./NOTICE.txt) records source provenance and modifications.

package/SOLID-SONNER-LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Robert Soriano <https://github.com/wobsoriano>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/SONNER-LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Emil Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/browser/index.d.ts

@@ -0,0 +1,219 @@
+/*!
+ * Derived from solid-sonner (https://github.com/wobsoriano/solid-sonner), src/.
+ * Copyright (c) 2022 Robert Soriano <https://github.com/wobsoriano>
+ * Derived from Sonner (https://github.com/emilkowalski/sonner), src/.
+ * Copyright (c) 2023 Emil Kowalski
+ * Modified for Solid Aria: Solid 2 reactivity, rendering, lifecycle, and packaging.
+ * MIT licensed. See LICENSE, SOLID-SONNER-LICENSE.md, SONNER-LICENSE.md, and NOTICE.txt in the package root.
+ */
+import { JSX } from "@solidjs/web";
+import { Setter } from "solid-js";
+type ToastTypes = "normal" | "action" | "success" | "info" | "warning" | "error" | "loading" | "default";
+type PromiseT<Data = unknown> = Promise<Data> | (() => Promise<Data>);
+type ToastContent = (() => JSX.Element) | JSX.Element;
+interface PromiseIExtendedResult extends ExternalToast {
+  message: JSX.Element | string;
+}
+type PromiseTExtendedResult<Data = unknown> = PromiseIExtendedResult | ((data: Data) => PromiseIExtendedResult | Promise<PromiseIExtendedResult>);
+type PromiseTResult<Data = unknown> = string | JSX.Element | ((data: Data) => JSX.Element | string | Promise<JSX.Element | string>);
+type PromiseExternalToast = Omit<ExternalToast, "description">;
+type PromiseData<ToastData = unknown> = PromiseExternalToast & {
+  loading?: string | JSX.Element;
+  success?: PromiseTResult<ToastData> | PromiseTExtendedResult<ToastData>;
+  error?: PromiseTResult | PromiseTExtendedResult;
+  description?: PromiseTResult;
+  finally?: () => void | Promise<void>;
+};
+interface ToastClassnames {
+  toast?: string;
+  title?: string;
+  description?: string;
+  loader?: string;
+  closeButton?: string;
+  cancelButton?: string;
+  actionButton?: string;
+  success?: string;
+  error?: string;
+  info?: string;
+  warning?: string;
+  loading?: string;
+  default?: string;
+  content?: string;
+  icon?: string;
+}
+interface ToastIcons {
+  success?: JSX.Element | null;
+  info?: JSX.Element | null;
+  warning?: JSX.Element | null;
+  error?: JSX.Element | null;
+  loading?: JSX.Element | null;
+  close?: JSX.Element | null;
+}
+interface Action {
+  label: JSX.Element;
+  onClick: (event: MouseEvent) => void;
+  actionButtonStyle?: JSX.CSSProperties;
+}
+interface ToastT {
+  id: number | string;
+  toasterId?: string;
+  title?: ToastContent;
+  type?: ToastTypes;
+  icon?: JSX.Element | null;
+  jsx?: JSX.Element;
+  richColors?: boolean;
+  invert?: boolean;
+  closeButton?: boolean;
+  dismissible?: boolean;
+  description?: ToastContent;
+  duration?: number;
+  delete?: boolean;
+  action?: Action | JSX.Element;
+  cancel?: Action | JSX.Element;
+  onDismiss?: (toast: ToastT) => void;
+  onAutoClose?: (toast: ToastT) => void;
+  promise?: PromiseT;
+  cancelButtonStyle?: JSX.CSSProperties;
+  actionButtonStyle?: JSX.CSSProperties;
+  style?: JSX.CSSProperties;
+  unstyled?: boolean;
+  className?: string;
+  classNames?: ToastClassnames;
+  descriptionClassName?: string;
+  position?: Position;
+  testId?: string;
+  class?: string;
+  classes?: ToastClassnames;
+  descriptionClass?: string;
+}
+declare function isAction(action: Action | JSX.Element): action is Action;
+type Position = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center";
+interface HeightT {
+  height: number;
+  toastId: number | string;
+  toasterId?: string;
+  position?: Position;
+}
+interface ToastOptions {
+  className?: string;
+  closeButton?: boolean;
+  descriptionClassName?: string;
+  style?: JSX.CSSProperties;
+  cancelButtonStyle?: JSX.CSSProperties;
+  actionButtonStyle?: JSX.CSSProperties;
+  duration?: number;
+  unstyled?: boolean;
+  classNames?: ToastClassnames;
+  closeButtonAriaLabel?: string;
+  toasterId?: string;
+  class?: string;
+  classes?: ToastClassnames;
+  descriptionClass?: string;
+}
+type Offset = {
+  top?: string | number;
+  right?: string | number;
+  bottom?: string | number;
+  left?: string | number;
+} | string | number;
+type SwipeDirection = "top" | "right" | "bottom" | "left";
+interface ToasterProps {
+  id?: string;
+  invert?: boolean;
+  theme?: "light" | "dark" | "system";
+  position?: Position;
+  hotkey?: string[];
+  richColors?: boolean;
+  expand?: boolean;
+  duration?: number;
+  gap?: number;
+  visibleToasts?: number;
+  closeButton?: boolean;
+  toastOptions?: ToastOptions;
+  className?: string;
+  style?: JSX.CSSProperties;
+  offset?: Offset;
+  mobileOffset?: Offset;
+  dir?: "rtl" | "ltr" | "auto";
+  swipeDirections?: SwipeDirection[];
+  icons?: ToastIcons;
+  customAriaLabel?: string;
+  containerAriaLabel?: string;
+  pauseWhenPageIsHidden?: boolean;
+  class?: string;
+}
+interface ToastProps {
+  toast: ToastT;
+  toasts: ToastT[];
+  index: number;
+  swipeDirections?: SwipeDirection[];
+  expanded: boolean;
+  invert: boolean;
+  heights: HeightT[];
+  setHeights: Setter<HeightT[]>;
+  removeToast: (toast: ToastT) => void;
+  gap?: number;
+  position: Position;
+  visibleToasts: number;
+  expandByDefault: boolean;
+  closeButton: boolean;
+  interacting: boolean;
+  style?: JSX.CSSProperties;
+  cancelButtonStyle?: JSX.CSSProperties;
+  actionButtonStyle?: JSX.CSSProperties;
+  duration?: number;
+  className?: string;
+  unstyled?: boolean;
+  descriptionClassName?: string;
+  classNames?: ToastClassnames;
+  icons?: ToastIcons;
+  closeButtonAriaLabel?: string;
+  defaultRichColors?: boolean;
+  pauseWhenPageIsHidden?: boolean;
+  class?: string;
+  classes?: ToastClassnames;
+  descriptionClass?: string;
+}
+declare enum SwipeStateTypes {
+  SwipedOut = "SwipedOut",
+  SwipedBack = "SwipedBack",
+  NotSwiped = "NotSwiped"
+}
+type Theme = "light" | "dark";
+interface ToastToDismiss {
+  id: number | string;
+  dismiss: boolean;
+}
+type ExternalToast = Omit<ToastT, "id" | "type" | "title" | "jsx" | "delete" | "promise"> & {
+  id?: number | string;
+  toasterId?: string;
+};
+declare function toastFunction(message: ToastContent, data?: ExternalToast): string | number;
+declare const getHistory: () => ToastT[];
+declare const getToasts: () => ToastT[];
+export declare const toast: typeof toastFunction & {
+  custom: (jsx: (id: number | string) => JSX.Element, data?: ExternalToast) => string | number;
+  dismiss: (id?: number | string) => string | number | undefined;
+  error: (message: ToastContent, data?: ExternalToast) => string | number;
+  info: (message: ToastContent, data?: ExternalToast) => string | number;
+  loading: (message: ToastContent, data?: ExternalToast) => string | number;
+  message: (message: ToastContent, data?: ExternalToast) => string | number;
+  promise: <ToastData>(promise: PromiseT<ToastData>, data?: PromiseData<ToastData> | undefined) => {
+    unwrap: () => Promise<ToastData>;
+  } | (string & {
+    unwrap: () => Promise<ToastData>;
+  }) | (number & {
+    unwrap: () => Promise<ToastData>;
+  }) | undefined;
+  success: (message: ToastContent, data?: ExternalToast) => string | number;
+  warning: (message: ToastContent, data?: ExternalToast) => string | number;
+} & {
+  getHistory: typeof getHistory;
+  getToasts: typeof getToasts;
+};
+declare function useSonner(): {
+  toasts: import("solid-js").SourceAccessor<ToastT[]>;
+};
+declare function Toaster(props: ToasterProps): JSX.Element;
+export { type Action, type ExternalToast, type HeightT, type Offset, type Position, type PromiseData, type PromiseExternalToast, type PromiseIExtendedResult, type PromiseT, type PromiseTExtendedResult, type PromiseTResult, type SwipeDirection, type SwipeStateTypes, type Theme, type ToastClassnames, type ToastContent, type ToastIcons, type ToastOptions, type ToastProps, type ToastT, type ToastToDismiss, type ToastTypes, Toaster, type ToasterProps, type isAction, useSonner };
+//# sourceMappingURL=index.d.ts.map