@vireocodedev/ui 0.2.0 → 0.2.1

package/dist/integrations/localization/providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.d.ts

@@ -0,0 +1,5 @@
+import "../../../../integrations/localization/services/dayjsSetup.js";
+import React from "react";
+import type { VireoTemporalLocalizationProviderProps } from "./VireoTemporalLocalizationProvider.types.js";
+/** Provides an explicit, scoped Day.js and MUI X localization boundary for Vireo temporal fields. */
+export declare function VireoTemporalLocalizationProvider({ adapterLocale, children, dateFormats, locale, localeText, }: VireoTemporalLocalizationProviderProps): React.JSX.Element;

package/dist/integrations/localization/providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.js

@@ -0,0 +1,31 @@
+"use client";
+var _a;
+import { jsx as _jsx } from "react/jsx-runtime";
+import "../../../../integrations/localization/services/dayjsSetup.js";
+import { resolveVireoAdapterLocale, resolveVireoPickerTextLocale, } from "../../../../integrations/localization/utils/localeResolver.js";
+import { LocalizationProvider } from "@mui/x-date-pickers/LocalizationProvider";
+import { AdapterDayjs } from "@mui/x-date-pickers/AdapterDayjs";
+import { enUS, hrHR } from "@mui/x-date-pickers/locales";
+import React from "react";
+const VIREO_TEMPORAL_ADAPTER_MARKER = Symbol.for("@vireocodedev/ui/VireoTemporalLocalizationProvider");
+class VireoAdapterDayjs extends AdapterDayjs {
+    constructor() {
+        super(...arguments);
+        this[_a] = true;
+    }
+}
+_a = VIREO_TEMPORAL_ADAPTER_MARKER;
+const BUNDLED_LOCALE_TEXT = {
+    en: enUS.components.MuiLocalizationProvider.defaultProps.localeText,
+    hr: hrHR.components.MuiLocalizationProvider.defaultProps.localeText,
+};
+/** Provides an explicit, scoped Day.js and MUI X localization boundary for Vireo temporal fields. */
+export function VireoTemporalLocalizationProvider({ adapterLocale, children, dateFormats, locale, localeText, }) {
+    const resolvedAdapterLocale = resolveVireoAdapterLocale(locale, adapterLocale);
+    const bundledLocaleText = BUNDLED_LOCALE_TEXT[resolveVireoPickerTextLocale(locale)];
+    const resolvedLocaleText = React.useMemo(() => ({
+        ...bundledLocaleText,
+        ...localeText,
+    }), [bundledLocaleText, localeText]);
+    return (_jsx(LocalizationProvider, { adapterLocale: resolvedAdapterLocale, dateAdapter: VireoAdapterDayjs, dateFormats: dateFormats, localeText: resolvedLocaleText, children: children }));
+}

package/dist/integrations/localization/providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.types.d.ts

@@ -0,0 +1,18 @@
+import type { AdapterFormats } from "@mui/x-date-pickers/models";
+import type { PickersInputLocaleText } from "@mui/x-date-pickers/locales";
+import type React from "react";
+export declare const VIREO_TEMPORAL_BASE_LOCALES: readonly ["en", "hr"];
+export type VireoTemporalBaseLocale = (typeof VIREO_TEMPORAL_BASE_LOCALES)[number];
+/** Known built-in locales plus consumer-registered Day.js locale identifiers. */
+export type VireoTemporalLocale = VireoTemporalBaseLocale | (string & {});
+export type VireoTemporalLocalizationProviderProps = {
+    /** Optional Day.js locale override when the semantic locale uses another identifier. */
+    adapterLocale?: string;
+    children: React.ReactNode;
+    /** Overrides adapter formats for every picker inside this provider scope. */
+    dateFormats?: Partial<AdapterFormats>;
+    /** Semantic application locale. English and Croatian are available without extra imports. */
+    locale: VireoTemporalLocale;
+    /** Overrides the bundled English or Croatian MUI picker text. */
+    localeText?: PickersInputLocaleText;
+};

package/dist/integrations/localization/providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.types.js

@@ -0,0 +1 @@
+export const VIREO_TEMPORAL_BASE_LOCALES = ["en", "hr"];

package/dist/integrations/localization/public.d.ts

@@ -0,0 +1,2 @@
+export { VireoTemporalLocalizationProvider } from "./providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.js";
+export { VIREO_TEMPORAL_BASE_LOCALES, type VireoTemporalBaseLocale, type VireoTemporalLocale, type VireoTemporalLocalizationProviderProps, } from "./providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.types.js";

package/dist/integrations/localization/public.js

@@ -0,0 +1,3 @@
+"use client";
+export { VireoTemporalLocalizationProvider } from "./providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.js";
+export { VIREO_TEMPORAL_BASE_LOCALES, } from "./providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.types.js";

package/dist/integrations/localization/services/dayjsSetup.d.ts

@@ -0,0 +1,2 @@
+import "dayjs/locale/en";
+import "dayjs/locale/hr";

package/dist/integrations/localization/services/dayjsSetup.js

@@ -0,0 +1,5 @@
+import dayjs from "dayjs";
+import "dayjs/locale/en";
+import "dayjs/locale/hr";
+import utc from "dayjs/plugin/utc";
+dayjs.extend(utc);

package/dist/integrations/localization/utils/localeResolver.d.ts

@@ -0,0 +1,4 @@
+import type { VireoTemporalLocale } from "../../../integrations/localization/providers/VireoTemporalLocalizationProvider/VireoTemporalLocalizationProvider.types.js";
+export declare function resolveVireoAdapterLocale(locale: VireoTemporalLocale, adapterLocale?: string): string;
+export declare function resolveVireoPickerTextLocale(locale: VireoTemporalLocale): "en" | "hr";
+export declare function resetVireoLocaleWarningsForTests(): void;

package/dist/integrations/localization/utils/localeResolver.js

@@ -0,0 +1,31 @@
+import dayjs from "dayjs";
+const warnedLocales = new Set();
+function localeCandidates(locale) {
+    const normalized = locale.trim().replaceAll("_", "-").toLowerCase();
+    if (!normalized)
+        return [];
+    const baseLocale = normalized.split("-")[0];
+    return baseLocale && baseLocale !== normalized ? [normalized, baseLocale] : [normalized];
+}
+function isRegisteredDayjsLocale(locale) {
+    return dayjs().locale(locale).locale() === locale;
+}
+export function resolveVireoAdapterLocale(locale, adapterLocale) {
+    const requestedLocale = adapterLocale ?? locale;
+    const resolvedLocale = localeCandidates(requestedLocale).find(isRegisteredDayjsLocale);
+    if (resolvedLocale)
+        return resolvedLocale;
+    if (process.env.NODE_ENV !== "production" && !warnedLocales.has(requestedLocale)) {
+        warnedLocales.add(requestedLocale);
+        console.warn(`VireoTemporalLocalizationProvider could not resolve the Day.js locale "${requestedLocale}". ` +
+            'Falling back to "en". Import the matching Day.js locale module before rendering the provider.');
+    }
+    return "en";
+}
+export function resolveVireoPickerTextLocale(locale) {
+    const baseLocale = localeCandidates(locale).at(-1);
+    return baseLocale === "hr" ? "hr" : "en";
+}
+export function resetVireoLocaleWarningsForTests() {
+    warnedLocales.clear();
+}

package/dist/integrations/react-i18next/hooks/useHistoryTranslation/useHistoryTranslation.d.ts

@@ -0,0 +1,2 @@
+/** Returns the app-owned i18next instance bound to Starter's history namespace. */
+export declare function useHistoryTranslation(): import("react-i18next").UseTranslationResponse<"history", undefined>;

package/dist/integrations/react-i18next/hooks/useHistoryTranslation/useHistoryTranslation.js

@@ -0,0 +1,7 @@
+"use client";
+import { HISTORY_TRANSLATION_NAMESPACE } from "@vireocodedev/localization";
+import { useTranslation } from "react-i18next";
+/** Returns the app-owned i18next instance bound to Starter's history namespace. */
+export function useHistoryTranslation() {
+    return useTranslation(HISTORY_TRANSLATION_NAMESPACE);
+}

package/dist/integrations/react-i18next/hooks/usePlatformTranslation/usePlatformTranslation.d.ts

@@ -0,0 +1,2 @@
+/** Returns the app-owned i18next instance bound to Starter's platform namespace. */
+export declare function usePlatformTranslation(): import("react-i18next").UseTranslationResponse<"platform", undefined>;

package/dist/integrations/react-i18next/hooks/usePlatformTranslation/usePlatformTranslation.js

@@ -0,0 +1,7 @@
+"use client";
+import { PLATFORM_TRANSLATION_NAMESPACE } from "@vireocodedev/localization";
+import { useTranslation } from "react-i18next";
+/** Returns the app-owned i18next instance bound to Starter's platform namespace. */
+export function usePlatformTranslation() {
+    return useTranslation(PLATFORM_TRANSLATION_NAMESPACE);
+}

package/dist/integrations/react-i18next/hooks/useQueryEngineTranslation/useQueryEngineTranslation.d.ts

@@ -0,0 +1,2 @@
+/** Returns the app-owned i18next instance bound to Starter's QueryEngine namespace. */
+export declare function useQueryEngineTranslation(): import("react-i18next").UseTranslationResponse<"queryengine", undefined>;

package/dist/integrations/react-i18next/hooks/useQueryEngineTranslation/useQueryEngineTranslation.js

@@ -0,0 +1,7 @@
+"use client";
+import { QUERYENGINE_TRANSLATION_NAMESPACE } from "@vireocodedev/localization";
+import { useTranslation } from "react-i18next";
+/** Returns the app-owned i18next instance bound to Starter's QueryEngine namespace. */
+export function useQueryEngineTranslation() {
+    return useTranslation(QUERYENGINE_TRANSLATION_NAMESPACE);
+}

package/dist/integrations/react-i18next/public.d.ts

@@ -0,0 +1,3 @@
+export { useHistoryTranslation } from "./hooks/useHistoryTranslation/useHistoryTranslation.js";
+export { usePlatformTranslation } from "./hooks/usePlatformTranslation/usePlatformTranslation.js";
+export { useQueryEngineTranslation } from "./hooks/useQueryEngineTranslation/useQueryEngineTranslation.js";

package/dist/integrations/react-i18next/public.js

@@ -0,0 +1,4 @@
+"use client";
+export { useHistoryTranslation } from "./hooks/useHistoryTranslation/useHistoryTranslation.js";
+export { usePlatformTranslation } from "./hooks/usePlatformTranslation/usePlatformTranslation.js";
+export { useQueryEngineTranslation } from "./hooks/useQueryEngineTranslation/useQueryEngineTranslation.js";

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.classes.d.ts

@@ -0,0 +1,9 @@
+import { type VireoToasterSlotName } from "./VireoToaster.identity.js";
+/** Utility classes available to VireoToaster. */
+export type VireoToasterClasses = Record<VireoToasterSlotName, string>;
+/** Valid keys for VireoToaster utility classes and theme style overrides. */
+export type VireoToasterClassKey = keyof VireoToasterClasses;
+/** Returns the generated utility class name for a VireoToaster slot or state. */
+export declare function getVireoToasterUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoToaster class key. */
+export declare const vireoToasterClasses: VireoToasterClasses;

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.classes.js

@@ -0,0 +1,10 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_TOASTER_NAME, VIREO_TOASTER_SLOTS } from "./VireoToaster.identity.js";
+/** Returns the generated utility class name for a VireoToaster slot or state. */
+export function getVireoToasterUtilityClass(slot) {
+    return generateUtilityClass(VIREO_TOASTER_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoToaster class key. */
+export const vireoToasterClasses = generateUtilityClasses(VIREO_TOASTER_NAME, [
+    ...VIREO_TOASTER_SLOTS,
+]);

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import { type ToasterProps } from "sonner";
+/** Renders the single global, MUI-themed Sonner notification region for an application. */
+export declare const VireoToaster: React.ForwardRefExoticComponent<import("./VireoToaster.types.js").VireoToasterSlotsAndSlotProps & {
+    classes?: Partial<import("./VireoToaster.classes.js").VireoToasterClasses>;
+    sx?: import("@mui/system").SxProps<import("@mui/material").Theme>;
+} & Omit<ToasterProps, "className" | "style" | "theme"> & {
+    className?: string;
+    style?: React.CSSProperties;
+} & React.RefAttributes<HTMLElement>>;

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.identity.d.ts

@@ -0,0 +1,6 @@
+/** Stable component name shared by every VireoToaster integration point. */
+export declare const VIREO_TOASTER_NAME = "VireoToaster";
+/** Canonical public slots exposed by VireoToaster, in rendered DOM order. */
+export declare const VIREO_TOASTER_SLOTS: readonly ["root"];
+/** Public slot names exposed by VireoToaster. */
+export type VireoToasterSlotName = (typeof VIREO_TOASTER_SLOTS)[number];

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.identity.js

@@ -0,0 +1,4 @@
+/** Stable component name shared by every VireoToaster integration point. */
+export const VIREO_TOASTER_NAME = "VireoToaster";
+/** Canonical public slots exposed by VireoToaster, in rendered DOM order. */
+export const VIREO_TOASTER_SLOTS = ["root"];

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.js

@@ -0,0 +1,66 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { joinClassNames, mergeSx, resolveSlotProps } from "../../../../../core/public.js";
+import { unstable_composeClasses as composeClasses, useMediaQuery } from "@mui/material";
+import { useTheme, useThemeProps } from "@mui/material/styles";
+import { useForkRef } from "@mui/material/utils";
+import React from "react";
+import { getVireoToasterUtilityClass } from "./VireoToaster.classes.js";
+import { VIREO_TOASTER_NAME } from "./VireoToaster.identity.js";
+import { VireoToasterRoot } from "./VireoToaster.styled.js";
+function useUtilityClasses(_ownerState, classes) {
+    return composeClasses({
+        root: ["root"],
+    }, getVireoToasterUtilityClass, classes);
+}
+function mergeToastClassNames(defaults, overrides) {
+    if (!defaults)
+        return overrides;
+    if (!overrides)
+        return defaults;
+    const keys = new Set([...Object.keys(defaults), ...Object.keys(overrides)]);
+    return Object.fromEntries(Array.from(keys, key => [key, joinClassNames(defaults[key], overrides[key])]));
+}
+function mergeToastOptions(defaults, overrides) {
+    if (!defaults)
+        return overrides;
+    if (!overrides)
+        return defaults;
+    return {
+        ...defaults,
+        ...overrides,
+        classNames: mergeToastClassNames(defaults.classNames, overrides.classNames),
+        style: { ...defaults.style, ...overrides.style },
+    };
+}
+/** Renders the single global, MUI-themed Sonner notification region for an application. */
+export const VireoToaster = React.forwardRef(function VireoToaster(inProps, forwardedRef) {
+    const theme = useTheme();
+    const props = useThemeProps({ props: inProps, name: VIREO_TOASTER_NAME });
+    const mobile = useMediaQuery(theme.breakpoints.down("sm"));
+    const themeDefaultToastOptions = theme.components?.[VIREO_TOASTER_NAME]?.defaultProps?.toastOptions;
+    const { className, classes: classesProp, closeButton: closeButtonProp, containerAriaLabel = "Notifications", dir: directionProp, duration = 3000, expand = false, gap = 14, hotkey = ["altKey", "KeyT"], mobileOffset: mobileOffsetProp, offset: offsetProp, position: positionProp, richColors = true, slotProps = {}, slots = {}, style, swipeDirections: swipeDirectionsProp, sx, toastOptions: toastOptionsProp, visibleToasts = 3, ...other } = props;
+    const direction = directionProp ?? theme.direction;
+    const position = positionProp ?? (mobile ? "top-center" : "bottom-right");
+    const closeButton = closeButtonProp ?? !mobile;
+    const swipeDirections = swipeDirectionsProp ?? (mobile ? ["top"] : ["right"]);
+    const offset = offsetProp ?? 24;
+    const mobileOffset = mobileOffsetProp ?? offsetProp ?? "calc(8px + env(safe-area-inset-top, 0px))";
+    const toastOptions = mergeToastOptions(themeDefaultToastOptions, toastOptionsProp);
+    const ownerState = {
+        mobile,
+        themeMode: theme.palette.mode,
+        direction,
+        position,
+        closeButton,
+        expand,
+        richColors,
+    };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, theme: _ignoredRootTheme, ...rootSlotOther } = resolvedRootSlotProps;
+    void _ignoredRootTheme;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    return (_jsx(VireoToasterRoot, { ...other, ...rootSlotOther, as: slots.root, ref: rootRef, ownerState: ownerState, className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), sonnerTheme: theme.palette.mode, dir: direction, position: position, closeButton: closeButton, containerAriaLabel: containerAriaLabel, duration: duration, expand: expand, gap: gap, hotkey: hotkey, mobileOffset: mobileOffset, offset: offset, richColors: richColors, swipeDirections: swipeDirections, toastOptions: toastOptions, visibleToasts: visibleToasts }));
+});
+VireoToaster.displayName = VIREO_TOASTER_NAME;

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.styled.d.ts

@@ -0,0 +1,15 @@
+import type { SxProps, Theme } from "@mui/material";
+import React from "react";
+import { type ToasterProps } from "sonner";
+import { type VireoToasterOwnerState } from "./VireoToaster.types.js";
+type SonnerToasterAdapterProps = Omit<ToasterProps, "theme"> & {
+    sonnerTheme: "light" | "dark";
+};
+type VireoToasterRootProps = SonnerToasterAdapterProps & {
+    as?: React.ElementType;
+    ownerState: VireoToasterOwnerState;
+    sx?: SxProps<Theme>;
+};
+type VireoToasterRootComponent = React.ForwardRefExoticComponent<VireoToasterRootProps & React.RefAttributes<HTMLElement>>;
+export declare const VireoToasterRoot: VireoToasterRootComponent;
+export {};

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.styled.js

@@ -0,0 +1,58 @@
+import { alpha, styled } from "@mui/material/styles";
+import React from "react";
+import { Toaster } from "sonner";
+import { VIREO_TOASTER_NAME } from "./VireoToaster.identity.js";
+const SonnerToasterAdapter = React.forwardRef(function SonnerToasterAdapter({ sonnerTheme, ...props }, ref) {
+    return React.createElement(Toaster, { ...props, ref, theme: sonnerTheme });
+});
+export const VireoToasterRoot = styled(SonnerToasterAdapter, {
+    name: VIREO_TOASTER_NAME,
+    slot: "Root",
+    overridesResolver: (_props, styles) => styles.root,
+    shouldForwardProp: prop => prop !== "as" && prop !== "ownerState" && prop !== "sx",
+})(({ theme }) => {
+    const semanticColors = (color) => ({
+        background: alpha(color.main, theme.palette.mode === "dark" ? 0.18 : 0.1),
+        border: alpha(color.main, 0.42),
+        text: theme.palette.mode === "dark" ? color.light : color.dark,
+    });
+    const success = semanticColors(theme.palette.success);
+    const info = semanticColors(theme.palette.info);
+    const warning = semanticColors(theme.palette.warning);
+    const error = semanticColors(theme.palette.error);
+    return {
+        "--normal-bg": theme.palette.background.paper,
+        "--normal-bg-hover": theme.palette.action.hover,
+        "--normal-border": theme.palette.divider,
+        "--normal-border-hover": theme.palette.action.selected,
+        "--normal-text": theme.palette.text.primary,
+        "--success-bg": success.background,
+        "--success-border": success.border,
+        "--success-text": success.text,
+        "--info-bg": info.background,
+        "--info-border": info.border,
+        "--info-text": info.text,
+        "--warning-bg": warning.background,
+        "--warning-border": warning.border,
+        "--warning-text": warning.text,
+        "--error-bg": error.background,
+        "--error-border": error.border,
+        "--error-text": error.text,
+        fontFamily: theme.typography.fontFamily,
+        "& [data-sonner-toast][data-styled='true']": {
+            borderRadius: theme.shape.borderRadius,
+            boxShadow: theme.shadows[6],
+            fontFamily: "inherit",
+        },
+        "& [data-title]": {
+            ...theme.typography.body2,
+            fontWeight: theme.typography.fontWeightMedium,
+        },
+        "& [data-description]": theme.typography.caption,
+        "& [data-button]": {
+            borderRadius: theme.shape.borderRadius,
+            fontFamily: "inherit",
+            fontWeight: theme.typography.fontWeightMedium,
+        },
+    };
+});

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.types.d.ts

@@ -0,0 +1,47 @@
+import type { VireoDataAttributeValue, VireoThemeComponent } from "../../../../../core/public.js";
+import type { SxProps, Theme } from "@mui/material";
+import type { CreateSlotsAndSlotProps, SlotProps } from "@mui/material/utils";
+import type React from "react";
+import type { Toaster, ToasterProps } from "sonner";
+import { type VireoToasterClasses, type VireoToasterClassKey } from "./VireoToaster.classes.js";
+import type { VIREO_TOASTER_NAME, VireoToasterSlotName } from "./VireoToaster.identity.js";
+export type VireoToasterOwnerState = {
+    mobile: boolean;
+    themeMode: "light" | "dark";
+    direction: NonNullable<ToasterProps["dir"]>;
+    position: NonNullable<ToasterProps["position"]>;
+    closeButton: boolean;
+    expand: boolean;
+    richColors: boolean;
+};
+export interface VireoToasterRootSlotPropsOverrides {
+    [key: `data-${string}`]: VireoDataAttributeValue;
+}
+/** Replaceable semantic regions exposed by {@link VireoToaster}. */
+export type VireoToasterSlots = {
+    [TSlotName in VireoToasterSlotName]: React.ElementType;
+};
+/** Slot props exposed by {@link VireoToaster}. */
+export type VireoToasterSlotsAndSlotProps = CreateSlotsAndSlotProps<VireoToasterSlots, {
+    /** @default Sonner Toaster */
+    root: SlotProps<typeof Toaster, VireoToasterRootSlotPropsOverrides, VireoToasterOwnerState>;
+}>;
+/** Props owned by {@link VireoToaster}. */
+export type VireoToasterOwnProps = VireoToasterSlotsAndSlotProps & {
+    /** Override or extend the utility classes applied to each slot. */
+    classes?: Partial<VireoToasterClasses>;
+    /** Styles applied to Sonner's generated toaster root without introducing wrapper DOM. */
+    sx?: SxProps<Theme>;
+};
+/** Props VireoToaster inherits from its default root after excluding component-owned props. */
+export type VireoToasterInheritedProps = Omit<ToasterProps, "className" | "style" | "theme"> & {
+    className?: string;
+    style?: React.CSSProperties;
+};
+/** Props accepted by {@link VireoToaster}. */
+export type VireoToasterProps = VireoToasterOwnProps & VireoToasterInheritedProps;
+declare module "@mui/material/styles" {
+    interface Components<Theme = unknown> {
+        [VIREO_TOASTER_NAME]?: VireoThemeComponent<VireoToasterProps, VireoToasterClassKey, VireoToasterOwnerState, Theme>;
+    }
+}

package/dist/integrations/sonner/components/feedback/VireoToaster/VireoToaster.types.js

@@ -0,0 +1 @@
+export {};

package/dist/integrations/sonner/components/feedback/VireoToaster/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./VireoToaster.js";
+export * from "./VireoToaster.classes.js";
+export * from "./VireoToaster.types.js";

package/dist/integrations/sonner/components/feedback/VireoToaster/index.js

@@ -0,0 +1,3 @@
+export * from "./VireoToaster.js";
+export * from "./VireoToaster.classes.js";
+export * from "./VireoToaster.types.js";

package/dist/integrations/sonner/public.d.ts

@@ -0,0 +1,3 @@
+export * from "./components/feedback/VireoToaster/index.js";
+export { toast } from "sonner";
+export type { Action, ExternalToast, ToastClassnames, ToastT, ToastToDismiss, ToasterProps as SonnerToasterProps, } from "sonner";

package/dist/integrations/sonner/public.js

@@ -0,0 +1,3 @@
+"use client";
+export * from "./components/feedback/VireoToaster/index.js";
+export { toast } from "sonner";

package/dist/integrations/tanstack-query/components/feedback/VireoQueryBoundary/VireoQueryBoundary.classes.d.ts

@@ -0,0 +1,9 @@
+import { type VireoQueryBoundarySlotName } from "./VireoQueryBoundary.identity.js";
+/** Utility classes available to VireoQueryBoundary. */
+export type VireoQueryBoundaryClasses = Record<VireoQueryBoundarySlotName | "loading" | "error" | "hasErrorDetails", string>;
+/** Valid keys for VireoQueryBoundary utility classes and theme style overrides. */
+export type VireoQueryBoundaryClassKey = keyof VireoQueryBoundaryClasses;
+/** Returns the generated utility class name for a VireoQueryBoundary slot or state. */
+export declare function getVireoQueryBoundaryUtilityClass(slot: string): string;
+/** Generated utility class names keyed by each public VireoQueryBoundary class key. */
+export declare const vireoQueryBoundaryClasses: VireoQueryBoundaryClasses;

package/dist/integrations/tanstack-query/components/feedback/VireoQueryBoundary/VireoQueryBoundary.classes.js

@@ -0,0 +1,13 @@
+import { generateUtilityClass, generateUtilityClasses } from "@mui/material";
+import { VIREO_QUERY_BOUNDARY_NAME, VIREO_QUERY_BOUNDARY_SLOTS, } from "./VireoQueryBoundary.identity.js";
+/** Returns the generated utility class name for a VireoQueryBoundary slot or state. */
+export function getVireoQueryBoundaryUtilityClass(slot) {
+    return generateUtilityClass(VIREO_QUERY_BOUNDARY_NAME, slot);
+}
+/** Generated utility class names keyed by each public VireoQueryBoundary class key. */
+export const vireoQueryBoundaryClasses = generateUtilityClasses(VIREO_QUERY_BOUNDARY_NAME, [
+    ...VIREO_QUERY_BOUNDARY_SLOTS,
+    "loading",
+    "error",
+    "hasErrorDetails",
+]);

package/dist/integrations/tanstack-query/components/feedback/VireoQueryBoundary/VireoQueryBoundary.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { type VireoQueryBoundaryProps } from "./VireoQueryBoundary.types.js";
+/** Coordinates Suspense loading, descendant errors, and TanStack Query reset semantics in one local boundary. */
+export declare const VireoQueryBoundary: React.ForwardRefExoticComponent<Omit<VireoQueryBoundaryProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/integrations/tanstack-query/components/feedback/VireoQueryBoundary/VireoQueryBoundary.identity.d.ts

@@ -0,0 +1,6 @@
+/** Stable component name shared by every VireoQueryBoundary integration point. */
+export declare const VIREO_QUERY_BOUNDARY_NAME = "VireoQueryBoundary";
+/** Canonical public slots exposed by VireoQueryBoundary, in rendered DOM order. */
+export declare const VIREO_QUERY_BOUNDARY_SLOTS: readonly ["root", "loadingIndicator", "errorAlert", "actions", "retryButton", "errorDetailsButton", "errorDetailsDialog"];
+/** Public slot names exposed by VireoQueryBoundary. */
+export type VireoQueryBoundarySlotName = (typeof VIREO_QUERY_BOUNDARY_SLOTS)[number];

package/dist/integrations/tanstack-query/components/feedback/VireoQueryBoundary/VireoQueryBoundary.identity.js

@@ -0,0 +1,12 @@
+/** Stable component name shared by every VireoQueryBoundary integration point. */
+export const VIREO_QUERY_BOUNDARY_NAME = "VireoQueryBoundary";
+/** Canonical public slots exposed by VireoQueryBoundary, in rendered DOM order. */
+export const VIREO_QUERY_BOUNDARY_SLOTS = [
+    "root",
+    "loadingIndicator",
+    "errorAlert",
+    "actions",
+    "retryButton",
+    "errorDetailsButton",
+    "errorDetailsDialog",
+];

package/dist/integrations/tanstack-query/components/feedback/VireoQueryBoundary/VireoQueryBoundary.js

@@ -0,0 +1,112 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { VireoJsonViewer, VireoLoadingRegion, joinClassNames, mergeSx, resolveSlotProps, } from "../../../../../core/public.js";
+import Close from "@mui/icons-material/Close";
+import InfoOutlined from "@mui/icons-material/InfoOutlined";
+import { AlertTitle, DialogContent, DialogTitle, IconButton, Tooltip, unstable_composeClasses as composeClasses, } from "@mui/material";
+import { useThemeProps } from "@mui/material/styles";
+import { useForkRef } from "@mui/material/utils";
+import { QueryErrorResetBoundary } from "@tanstack/react-query";
+import React from "react";
+import { ErrorBoundary } from "react-error-boundary";
+import { getVireoQueryBoundaryUtilityClass } from "./VireoQueryBoundary.classes.js";
+import { VIREO_QUERY_BOUNDARY_NAME } from "./VireoQueryBoundary.identity.js";
+import { VireoQueryBoundaryActions, VireoQueryBoundaryErrorAlert, VireoQueryBoundaryErrorDetailsButton, VireoQueryBoundaryErrorDetailsDialog, VireoQueryBoundaryLoadingIndicator, VireoQueryBoundaryRetryButton, VireoQueryBoundaryRoot, } from "./VireoQueryBoundary.styled.js";
+function useUtilityClasses(ownerState, classes) {
+    return composeClasses({
+        root: [
+            "root",
+            ownerState.status === "loading" && "loading",
+            ownerState.status === "error" && "error",
+            ownerState.hasErrorDetails && "hasErrorDetails",
+        ],
+        loadingIndicator: ["loadingIndicator"],
+        errorAlert: ["errorAlert"],
+        actions: ["actions"],
+        retryButton: ["retryButton"],
+        errorDetailsButton: ["errorDetailsButton"],
+        errorDetailsDialog: ["errorDetailsDialog"],
+    }, getVireoQueryBoundaryUtilityClass, classes);
+}
+function safelyResolveRetryable(retryable, error) {
+    if (typeof retryable !== "function")
+        return retryable ?? true;
+    try {
+        return retryable(error);
+    }
+    catch {
+        return false;
+    }
+}
+function safelySelectErrorDetails(selector, error) {
+    if (!selector)
+        return undefined;
+    try {
+        return selector(error);
+    }
+    catch {
+        return undefined;
+    }
+}
+const VireoQueryBoundaryFallback = React.forwardRef(function VireoQueryBoundaryFallback(props, forwardedRef) {
+    const { className, classes: classesProp, closeErrorDetailsLabel = "Close error details", copiedErrorDetailsLabel = "Error details copied", copyErrorDetailsLabel = "Copy error details", error, errorDetailsLabel = "Show error details", errorDetailsTitle = "Error details", errorMessage = "The requested content could not be loaded.", errorTitle = "Something went wrong", loadingLabel = "Loading", loadingRevealDelay, announceLoading = true, onRetry, retry, retryLabel = "Retry", retryable: retryableProp = true, selectErrorDetails, slotProps = {}, slots = {}, status, style, sx, ...other } = props;
+    const retryable = status === "error" && safelyResolveRetryable(retryableProp, error);
+    const errorDetails = React.useMemo(() => (status === "error" ? safelySelectErrorDetails(selectErrorDetails, error) : undefined), [error, selectErrorDetails, status]);
+    const hasErrorDetails = errorDetails !== null && errorDetails !== undefined;
+    const ownerState = { status, hasErrorDetails, retryable };
+    const classes = useUtilityClasses(ownerState, classesProp);
+    const [detailsOpen, setDetailsOpen] = React.useState(false);
+    const detailsTitleId = React.useId();
+    React.useEffect(() => setDetailsOpen(false), [error]);
+    const resolvedRootSlotProps = resolveSlotProps(slotProps.root, ownerState);
+    const resolvedLoadingIndicatorSlotProps = resolveSlotProps(slotProps.loadingIndicator, ownerState);
+    const resolvedErrorAlertSlotProps = resolveSlotProps(slotProps.errorAlert, ownerState);
+    const resolvedActionsSlotProps = resolveSlotProps(slotProps.actions, ownerState);
+    const resolvedRetryButtonSlotProps = resolveSlotProps(slotProps.retryButton, ownerState);
+    const resolvedErrorDetailsButtonSlotProps = resolveSlotProps(slotProps.errorDetailsButton, ownerState);
+    const resolvedErrorDetailsDialogSlotProps = resolveSlotProps(slotProps.errorDetailsDialog, ownerState);
+    const { className: rootSlotClassName, ref: rootSlotRef, style: rootSlotStyle, sx: rootSlotSx, ...rootSlotOther } = resolvedRootSlotProps;
+    const rootRef = useForkRef(forwardedRef, rootSlotRef);
+    const { className: loadingClassName, size: loadingSize, ...loadingOther } = resolvedLoadingIndicatorSlotProps;
+    const { className: alertClassName, ...alertOther } = resolvedErrorAlertSlotProps;
+    const { className: actionsClassName, sx: actionsSx, ...actionsOther } = resolvedActionsSlotProps;
+    const { className: retryClassName, onClick: retrySlotOnClick, ...retryOther } = resolvedRetryButtonSlotProps;
+    const { className: detailsButtonClassName, onClick: detailsButtonSlotOnClick, ...detailsButtonOther } = resolvedErrorDetailsButtonSlotProps;
+    const { className: dialogClassName, onClose: dialogSlotOnClose, open: _ignoredDialogOpen, ...dialogOther } = resolvedErrorDetailsDialogSlotProps;
+    void _ignoredDialogOpen;
+    const handleRetry = React.useCallback(event => {
+        retrySlotOnClick?.(event);
+        if (!event.defaultPrevented && retry) {
+            onRetry?.(error);
+            retry();
+        }
+    }, [error, onRetry, retry, retrySlotOnClick]);
+    const handleOpenDetails = React.useCallback(event => {
+        detailsButtonSlotOnClick?.(event);
+        if (!event.defaultPrevented)
+            setDetailsOpen(true);
+    }, [detailsButtonSlotOnClick]);
+    const handleCloseDetails = React.useCallback((event, reason) => {
+        dialogSlotOnClose?.(event, reason);
+        if (!event.defaultPrevented)
+            setDetailsOpen(false);
+    }, [dialogSlotOnClose]);
+    return (_jsx(VireoQueryBoundaryRoot, { ...other, ...rootSlotOther, as: slots.root ?? "div", ref: rootRef, ownerState: ownerState, className: joinClassNames(classes.root, className, rootSlotClassName), style: { ...style, ...rootSlotStyle }, sx: mergeSx(sx, rootSlotSx), children: status === "loading" ? (_jsx(VireoLoadingRegion, { announce: announceLoading, loading: true, loadingLabel: loadingLabel, revealDelay: loadingRevealDelay, children: ({ loadingVisible }) => loadingVisible ? (_jsx(VireoQueryBoundaryLoadingIndicator, { ...loadingOther, as: slots.loadingIndicator, ownerState: ownerState, className: joinClassNames(classes.loadingIndicator, loadingClassName), size: loadingSize ?? "3rem", "aria-hidden": "true" })) : null })) : (_jsxs(VireoQueryBoundaryErrorAlert, { severity: "error", ...alertOther, as: slots.errorAlert, ownerState: ownerState, className: joinClassNames(classes.errorAlert, alertClassName), role: "alert", children: [_jsx(AlertTitle, { children: errorTitle }), errorMessage, (retryable || hasErrorDetails) && (_jsxs(VireoQueryBoundaryActions, { direction: "row", spacing: 1, ...actionsOther, as: slots.actions, ownerState: ownerState, className: joinClassNames(classes.actions, actionsClassName), sx: mergeSx({ alignItems: "center" }, actionsSx), children: [retryable && (_jsx(VireoQueryBoundaryRetryButton, { variant: "outlined", color: "inherit", ...retryOther, as: slots.retryButton, ownerState: ownerState, className: joinClassNames(classes.retryButton, retryClassName), onClick: handleRetry, children: retryLabel })), hasErrorDetails && (_jsx(Tooltip, { title: errorDetailsLabel, children: _jsx(VireoQueryBoundaryErrorDetailsButton, { size: "small", ...detailsButtonOther, as: slots.errorDetailsButton, ownerState: ownerState, className: joinClassNames(classes.errorDetailsButton, detailsButtonClassName), "aria-label": errorDetailsLabel, onClick: handleOpenDetails, children: _jsx(InfoOutlined, { fontSize: "small" }) }) }))] })), hasErrorDetails && (_jsxs(VireoQueryBoundaryErrorDetailsDialog, { ...dialogOther, as: slots.errorDetailsDialog, ownerState: ownerState, className: joinClassNames(classes.errorDetailsDialog, dialogClassName), open: detailsOpen, onClose: handleCloseDetails, "aria-labelledby": detailsTitleId, fullWidth: true, maxWidth: "md", children: [_jsxs(DialogTitle, { id: detailsTitleId, sx: { pr: 7 }, children: [errorDetailsTitle, _jsx(IconButton, { "aria-label": closeErrorDetailsLabel, onClick: () => setDetailsOpen(false), sx: { position: "absolute", right: 8, top: 8 }, children: _jsx(Close, {}) })] }), _jsx(DialogContent, { children: _jsx(VireoJsonViewer, { data: errorDetails, copyLabel: copyErrorDetailsLabel, copiedLabel: copiedErrorDetailsLabel }) })] }))] })) }));
+});
+VireoQueryBoundaryFallback.displayName = `${VIREO_QUERY_BOUNDARY_NAME}Fallback`;
+/** Coordinates Suspense loading, descendant errors, and TanStack Query reset semantics in one local boundary. */
+export const VireoQueryBoundary = React.forwardRef(function VireoQueryBoundary(inProps, forwardedRef) {
+    const props = useThemeProps({ props: inProps, name: VIREO_QUERY_BOUNDARY_NAME });
+    const { children, errorFallback, loadingFallback, onError, onRetry, resetKeys = [], retryable = true, ...fallbackProps } = props;
+    return (_jsx(QueryErrorResetBoundary, { children: ({ reset }) => (_jsx(ErrorBoundary, { resetKeys: [...resetKeys], onReset: reset, onError: (error, info) => onError?.(error, { componentStack: info.componentStack ?? null }), fallbackRender: ({ error, resetErrorBoundary }) => {
+                const canRetry = safelyResolveRetryable(retryable, error);
+                const retry = () => {
+                    onRetry?.(error);
+                    resetErrorBoundary();
+                };
+                if (errorFallback)
+                    return errorFallback({ error, retry, retryable: canRetry });
+                return (_jsx(VireoQueryBoundaryFallback, { ...fallbackProps, onRetry: onRetry, ref: forwardedRef, status: "error", error: error, retry: resetErrorBoundary, retryable: retryable }));
+            }, children: _jsx(React.Suspense, { fallback: loadingFallback ?? _jsx(VireoQueryBoundaryFallback, { ...fallbackProps, ref: forwardedRef, status: "loading" }), children: children }) })) }));
+});
+VireoQueryBoundary.displayName = VIREO_QUERY_BOUNDARY_NAME;