@edifice.io/react 2.6.6-develop.20260923152855 → 2.6.7-develop-b2school.20260928143952

package/dist/components/ModalBeta/ModalBetaFooter.js

@@ -0,0 +1,7 @@
+import { jsx } from "react/jsx-runtime";
+const ModalBetaFooter = ({
+  children
+}) => /* @__PURE__ */ jsx("div", { className: "modal-beta-footer", children });
+export {
+  ModalBetaFooter as default
+};

package/dist/components/ModalBeta/ModalBetaHeader.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+export interface ModalBetaHeaderProps {
+    /**
+     * Method called on modal close
+     */
+    onModalClose: () => void;
+    /**
+     * Modal title
+     */
+    children: ReactNode;
+    /**
+     * Optional text displayed below the title
+     */
+    subtitle?: ReactNode;
+}
+/**
+ * ModalBeta Header
+ */
+declare const ModalBetaHeader: {
+    ({ onModalClose, children, subtitle, }: ModalBetaHeaderProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export default ModalBetaHeader;

package/dist/components/ModalBeta/ModalBetaHeader.js

@@ -0,0 +1,31 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useRef, useEffect } from "react";
+import { useTranslation } from "react-i18next";
+import SvgIconClose from "../../modules/icons/components/IconClose.js";
+import ButtonBeta from "../ButtonBeta/ButtonBeta.js";
+import { useModalBetaContext } from "./ModalBetaContext.js";
+const ModalBetaHeader = ({
+  onModalClose,
+  children,
+  subtitle
+}) => {
+  const {
+    ariaLabelId,
+    focusId
+  } = useModalBetaContext(), closeButtonRef = useRef(null), {
+    t
+  } = useTranslation();
+  return useEffect(() => {
+    var _a;
+    focusId || (_a = closeButtonRef.current) == null || _a.focus();
+  }, [focusId]), /* @__PURE__ */ jsxs("div", { className: "modal-beta-header", children: [
+    /* @__PURE__ */ jsxs("div", { className: "modal-beta-title-row", children: [
+      /* @__PURE__ */ jsx("h2", { id: ariaLabelId, className: "modal-beta-title", tabIndex: -1, children }),
+      /* @__PURE__ */ jsx(ButtonBeta, { ref: closeButtonRef, "aria-label": t("close"), title: t("close"), type: "button", variant: "ghost", color: "tertiary", leftIcon: /* @__PURE__ */ jsx(SvgIconClose, {}), onClick: onModalClose })
+    ] }),
+    subtitle && /* @__PURE__ */ jsx("p", { className: "modal-beta-subtitle", children: subtitle })
+  ] });
+};
+export {
+  ModalBetaHeader as default
+};

package/dist/components/ModalBeta/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ModalBeta } from './ModalBeta';
+export * from './ModalBeta';

package/dist/components/PageLayout/PageLayout.d.ts

@@ -41,5 +41,9 @@ declare const PageLayout: {
         ({ children, onClose, closeButton, backdrop, className, ...props }: import('./components/PageLayoutOverlay').PageLayoutOverlayProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
+    HelpZone: {
+        (): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
 };
 export default PageLayout;

package/dist/components/PageLayout/PageLayout.js

@@ -1,15 +1,21 @@
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsxs, jsx } from "react/jsx-runtime";
 import { useMemo, Children, isValidElement } from "react";
 import clsx from "clsx";
+import { useTranslation } from "react-i18next";
 import PageLayoutBreadcrumb from "./components/PageLayoutBreadcrumb.js";
 import PageLayoutContent from "./components/PageLayoutContent.js";
 import PageLayoutHeader from "./components/PageLayoutHeader.js";
+import PageLayoutHelpZone from "./components/PageLayoutHelpZone.js";
 import PageLayoutOverlay from "./components/PageLayoutOverlay.js";
 import PageLayoutSidebarLeft from "./components/PageLayoutSidebarLeft.js";
 import PageLayoutSidebarRight from "./components/PageLayoutSidebarRight.js";
 import { PageLayoutContext } from "./PageLayoutContext.js";
+import useCookiesConsent from "../../hooks/useCookiesConsent/useCookiesConsent.js";
+import useToast from "../../hooks/useToast/useToast.js";
+import Alert from "../Alert/Alert.js";
+import ButtonBeta from "../ButtonBeta/ButtonBeta.js";
 function analyzeChildren(children) {
-  let hasLeftSidebar = !1, hasRightSidebar = !1, breadcrumb = null, overlay = null;
+  let hasLeftSidebar = !1, hasRightSidebar = !1, breadcrumb = null, overlay = null, helpZone = null;
   const headerChildren = [], mainChildren = [];
   return Children.toArray(children).forEach((child) => {
     if (/* @__PURE__ */ isValidElement(child))
@@ -23,6 +29,9 @@ function analyzeChildren(children) {
         case PageLayoutOverlay:
           overlay = child;
           break;
+        case PageLayoutHelpZone:
+          helpZone = child;
+          break;
         case PageLayoutSidebarLeft:
           hasLeftSidebar = !0, mainChildren.push(child);
           break;
@@ -41,6 +50,7 @@ function analyzeChildren(children) {
     hasRightSidebar,
     breadcrumb,
     overlay,
+    helpZone,
     headerChildren,
     mainChildren
   };
@@ -54,15 +64,22 @@ const Root = ({
   className,
   ...props
 }) => {
-  const contextValue = useMemo(() => ({
+  const {
+    t
+  } = useTranslation(), {
+    showCookiesConsent,
+    handleConsultCookies,
+    handleCloseCookiesConsent
+  } = useCookiesConsent(), contextValue = useMemo(() => ({
     variant,
     scrollMode,
     noPadding
-  }), [variant, scrollMode, noPadding]), {
+  }), [variant, scrollMode, noPadding]), renderToaster = useToast().renderToaster(), {
     hasLeftSidebar,
     hasRightSidebar,
     breadcrumb,
     overlay,
+    helpZone,
     headerChildren,
     mainChildren
   } = analyzeChildren(children), mainAreaClasses = clsx("pagelayout-mainarea", {
@@ -71,23 +88,29 @@ const Root = ({
     "has-right-sidebar-only": !hasLeftSidebar && hasRightSidebar,
     "has-gap": withGap
   }), isFullpage = variant === "fullpage";
-  return /* @__PURE__ */ jsx(PageLayoutContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsxs("div", { className: clsx("pagelayout", `pagelayout-${variant}`, scrollMode && `pagelayout-scroll-${scrollMode}`, className), ...props, children: [
-    headerChildren,
-    headerChildren.length > 0 && /* @__PURE__ */ jsx("div", { className: "pagelayout-headerspacer" }),
-    !isFullpage && breadcrumb,
-    /* @__PURE__ */ jsxs("div", { className: mainAreaClasses, children: [
-      isFullpage && breadcrumb,
-      mainChildren
+  return /* @__PURE__ */ jsxs(PageLayoutContext.Provider, { value: contextValue, children: [
+    /* @__PURE__ */ jsxs("div", { className: clsx("pagelayout", `pagelayout-${variant}`, scrollMode && `pagelayout-scroll-${scrollMode}`, className), ...props, children: [
+      headerChildren,
+      headerChildren.length > 0 && /* @__PURE__ */ jsx("div", { className: "pagelayout-headerspacer" }),
+      !isFullpage && breadcrumb,
+      /* @__PURE__ */ jsxs("div", { className: mainAreaClasses, children: [
+        isFullpage && breadcrumb,
+        mainChildren
+      ] }),
+      overlay,
+      showCookiesConsent && /* @__PURE__ */ jsx(Alert, { type: "info", isConfirm: !0, position: "bottom-right", button: /* @__PURE__ */ jsx(ButtonBeta, { variant: "outline", onClick: handleConsultCookies, children: t("rgpd.cookies.banner.button.consult") }), onClose: handleCloseCookiesConsent, children: t("rgpd.cookies.banner.text1") })
     ] }),
-    overlay
-  ] }) });
+    helpZone,
+    renderToaster
+  ] });
 }, PageLayout = Object.assign(Root, {
   Header: PageLayoutHeader,
   Breadcrumb: PageLayoutBreadcrumb,
   SidebarLeft: PageLayoutSidebarLeft,
   Content: PageLayoutContent,
   SidebarRight: PageLayoutSidebarRight,
-  Overlay: PageLayoutOverlay
+  Overlay: PageLayoutOverlay,
+  HelpZone: PageLayoutHelpZone
 });
 export {
   PageLayout as default

package/dist/components/PageLayout/components/PageLayoutContent.js

@@ -1,15 +1,19 @@
 import { jsx } from "react/jsx-runtime";
 import clsx from "clsx";
 import { usePageLayout } from "../PageLayoutContext.js";
+import useBackground from "../../../hooks/useBackground/useBackground.js";
 const PageLayoutContent = ({
   children,
   className,
   ...props
 }) => {
   const {
+    productOverride,
+    background
+  } = useBackground(), {
     noPadding
   } = usePageLayout();
-  return /* @__PURE__ */ jsx("main", { className: clsx("pagelayout-content", {
+  return /* @__PURE__ */ jsx("main", { "data-product": productOverride, "data-background": background, className: clsx("pagelayout-content", {
     "pagelayout-content--no-padding": noPadding == null ? void 0 : noPadding.content
   }, className), ...props, children });
 };

package/dist/components/PageLayout/components/PageLayoutHelpZone.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Opt-in slot: renders the floating Edifice help zone (badge + support
+ * button). Requires `EdificeClientProvider` and `EdificeThemeProvider`
+ * higher in the tree (used internally by `useZendeskGuide`) — kept opt-in
+ * rather than baked into `PageLayout` itself so standalone consumers
+ * without those providers don't crash at render.
+ */
+declare const PageLayoutHelpZone: {
+    (): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export default PageLayoutHelpZone;

package/dist/components/PageLayout/components/PageLayoutHelpZone.js

@@ -0,0 +1,6 @@
+import { jsx } from "react/jsx-runtime";
+import { HelpZoneContainer } from "../../../modules/HelpZone/HelpZoneContainer.js";
+const PageLayoutHelpZone = () => /* @__PURE__ */ jsx(HelpZoneContainer, {});
+export {
+  PageLayoutHelpZone as default
+};

package/dist/components/Table/components/Table.d.ts

@@ -13,7 +13,7 @@ declare const Table: import('react').ForwardRefExoticComponent<{
         displayName: string;
     };
     Th: {
-        (props: React.HTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
+        (props: React.ThHTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
     Tbody: {
@@ -25,7 +25,7 @@ declare const Table: import('react').ForwardRefExoticComponent<{
         displayName: string;
     };
     Td: {
-        (props: React.HTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
+        (props: React.TdHTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
 };

package/dist/components/Table/components/TableTd.d.ts

@@ -1,4 +1,4 @@
 export declare const TableTd: {
-    (props: React.HTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
+    (props: React.TdHTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

package/dist/components/Table/components/TableTh.d.ts

@@ -1,4 +1,4 @@
 export declare const TableTh: {
-    (props: React.HTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
+    (props: React.ThHTMLAttributes<HTMLTableCellElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

package/dist/components/index.d.ts

@@ -28,6 +28,7 @@ export * from './Image';
 export * from './Input';
 export * from './Label';
 export * from './Layout';
+export * from './LinkPill';
 export * from './List';
 export * from './Loading';
 export * from './LoadingScreen';
@@ -36,6 +37,7 @@ export * from './LogoBeta';
 export * from './MediaViewer';
 export * from './Menu';
 export * from './Modal';
+export * from './ModalBeta';
 export * from './PageLayout';
 export * from './Pagination';
 export * from './Popover';

package/dist/homepage.js

@@ -16,9 +16,16 @@ import { Favorites } from "./modules/homepage/components/Favorites/Favorites.js"
 import { FavoritesContainer } from "./modules/homepage/components/Favorites/FavoritesContainer.js";
 import { LastInfosContainer } from "./modules/homepage/components/LastInfos/LastInfosContainer.js";
 import { LastInfosList } from "./modules/homepage/components/LastInfos/LastInfosList.js";
+import { LinkForm } from "./modules/homepage/components/UsefulLinks/LinkForm.js";
+import { MAX_USEFUL_LINKS, useUsefulLinksContainer } from "./modules/homepage/components/UsefulLinks/hooks/useUsefulLinksContainer.js";
 import { MessageFlashListContainer } from "./modules/homepage/components/MessageFlashList/MessageFlashListContainer.js";
 import { SchoolSpaceContainer } from "./modules/homepage/components/SchoolSpace/SchoolSpaceContainer.js";
+import { UsefulLinks } from "./modules/homepage/components/UsefulLinks/UsefulLinks.js";
+import { UsefulLinksContainer } from "./modules/homepage/components/UsefulLinks/UsefulLinksContainer.js";
+import { UsefulLinksModal } from "./modules/homepage/components/UsefulLinks/UsefulLinksModal.js";
 import { UserSpaceContainer } from "./modules/homepage/components/UserSpace/UserSpaceContainer.js";
+import { WidgetToggle } from "./modules/homepage/components/WidgetsPersonalizationPanel/WidgetToggle.js";
+import { WidgetsPersonalizationPanel } from "./modules/homepage/components/WidgetsPersonalizationPanel/WidgetsPersonalizationPanel.js";
 import { useCommunities } from "./modules/homepage/components/Communities/useCommunities.js";
 export {
   default2 as Communities,
@@ -32,6 +39,8 @@ export {
   default7 as LastInfos,
   LastInfosContainer,
   LastInfosList,
+  LinkForm,
+  MAX_USEFUL_LINKS,
   default8 as MessageFlash,
   default9 as MessageFlashList,
   MessageFlashListContainer,
@@ -40,7 +49,13 @@ export {
   NotificationListContainer,
   default12 as SchoolSpace,
   SchoolSpaceContainer,
+  UsefulLinks,
+  UsefulLinksContainer,
+  UsefulLinksModal,
   default13 as UserSpace,
   UserSpaceContainer,
-  useCommunities
+  WidgetToggle,
+  WidgetsPersonalizationPanel,
+  useCommunities,
+  useUsefulLinksContainer
 };

package/dist/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export * from './useBackground';
 export * from './useBookmark';
 export * from './useBreakpoint';
 export * from './useBrowserInfo';
@@ -34,6 +35,7 @@ export * from './useUiOverride';
 export * from './useUpload';
 export * from './useUploadFiles';
 export * from './useUser';
+export * from './useUserPreferences';
 export * from './useWorkspaceFile';
 export * from './useWorkspaceFolders';
 export * from './useWorkspaceSearch';

package/dist/hooks/useBackground/index.d.ts

@@ -0,0 +1 @@
+export { default as useBackground, type Background } from './useBackground';

package/dist/hooks/useBackground/useBackground.d.ts

@@ -0,0 +1,7 @@
+export type Background = 'default' | 'pink-200' | 'yellow-200' | 'orange-200' | 'blue-200' | 'green-200';
+declare const _default: () => {
+    background: Background;
+    isBackgroundImageOverridden: boolean;
+    productOverride: string | undefined;
+};
+export default _default;

package/dist/hooks/useBackground/useBackground.js

@@ -0,0 +1,16 @@
+import useUiOverride from "../useUiOverride/useUiOverride.js";
+import useUserPreferences from "../useUserPreferences/useUserPreferences.js";
+const useBackground = () => {
+  const backgroundOverride = useUiOverride("layout.background"), backgroundDefault = useUiOverride("background.default"), {
+    preferences
+  } = useUserPreferences(), isBackgroundImageOverridden = (backgroundOverride == null ? void 0 : backgroundOverride.variant) === "image";
+  return {
+    /* Actual background is either : user's prefered value, theme-conf overriden value or 'default' */
+    background: (preferences == null ? void 0 : preferences.background) ?? (backgroundDefault == null ? void 0 : backgroundDefault.variant) ?? "default",
+    isBackgroundImageOverridden,
+    productOverride: backgroundOverride == null ? void 0 : backgroundOverride.theme
+  };
+};
+export {
+  useBackground as default
+};

package/dist/hooks/useClickOutside/useClickOutside.d.ts

@@ -1 +1 @@
-export default function useClickOutside<T extends HTMLElement = any>(handler: () => void, events?: string[] | null, nodes?: Array<HTMLElement | null>): import('react').MutableRefObject<T | null>;
+export default function useClickOutside<T extends HTMLElement = any>(handler: () => void, events?: string[] | null, nodes?: Array<HTMLElement | null>, enabled?: boolean): import('react').MutableRefObject<T | null>;

package/dist/hooks/useClickOutside/useClickOutside.js

@@ -1,8 +1,9 @@
 import { useRef, useEffect } from "react";
 const DEFAULT_EVENTS = ["mousedown", "touchstart"];
-function useClickOutside(handler, events, nodes) {
+function useClickOutside(handler, events, nodes, enabled = !0) {
   const ref = useRef(null);
   return useEffect(() => {
+    if (!enabled) return;
     const listener = (event) => {
       const {
         target
@@ -19,7 +20,7 @@ function useClickOutside(handler, events, nodes) {
         document.removeEventListener(fn, listener);
       });
     };
-  }, [ref, handler, nodes, events]), ref;
+  }, [ref, handler, nodes, events, enabled]), ref;
 }
 export {
   useClickOutside as default

package/dist/hooks/useToast/useToast.d.ts

@@ -7,6 +7,7 @@ export interface CustomToastOptions {
     duration?: number;
 }
 export default function useToast(): {
+    renderToaster: () => import("react/jsx-runtime").JSX.Element;
     success: (message: string | ReactNode, options?: CustomToastOptions) => string;
     error: (message: string | ReactNode, options?: CustomToastOptions) => string;
     info: (message: string | ReactNode, options?: CustomToastOptions) => string;

package/dist/hooks/useToast/useToast.js

@@ -1,27 +1,30 @@
 import { jsx } from "react/jsx-runtime";
-import toast from "react-hot-toast";
+import toast, { Toaster } from "react-hot-toast";
 import Alert from "../../components/Alert/Alert.js";
 const DEFAULT_POSITION = "top-right", DEFAULT_DURATION = 5e3;
 function useToast() {
   return {
-    success: (message, options) => toast.custom(/* @__PURE__ */ jsx(Alert, { type: "success", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, className: "mb-12", children: message }), {
+    renderToaster: () => /* @__PURE__ */ jsx(Toaster, { containerClassName: "toaster-container", toastOptions: {
+      position: "top-right"
+    } }),
+    success: (message, options) => toast.custom((t) => /* @__PURE__ */ jsx(Alert, { type: "success", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, autoClose: !(options != null && options.isDismissible), autoCloseDelay: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION, onClose: () => toast.dismiss(t.id), className: "mb-12", children: message }), {
       id: options == null ? void 0 : options.id,
-      duration: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION,
+      duration: 1 / 0,
       position: (options == null ? void 0 : options.position) ?? DEFAULT_POSITION
     }),
-    error: (message, options) => toast.custom(/* @__PURE__ */ jsx(Alert, { type: "danger", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, className: "mb-12", children: message }), {
+    error: (message, options) => toast.custom((t) => /* @__PURE__ */ jsx(Alert, { type: "danger", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, autoClose: !(options != null && options.isDismissible), autoCloseDelay: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION, onClose: () => toast.dismiss(t.id), className: "mb-12", children: message }), {
       id: options == null ? void 0 : options.id,
-      duration: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION,
+      duration: 1 / 0,
       position: (options == null ? void 0 : options.position) ?? DEFAULT_POSITION
     }),
-    info: (message, options) => toast.custom(/* @__PURE__ */ jsx(Alert, { type: "info", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, className: "mb-12", children: message }), {
+    info: (message, options) => toast.custom((t) => /* @__PURE__ */ jsx(Alert, { type: "info", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, autoClose: !(options != null && options.isDismissible), autoCloseDelay: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION, onClose: () => toast.dismiss(t.id), className: "mb-12", children: message }), {
       id: options == null ? void 0 : options.id,
-      duration: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION,
+      duration: 1 / 0,
       position: (options == null ? void 0 : options.position) ?? DEFAULT_POSITION
     }),
-    warning: (message, options) => toast.custom(/* @__PURE__ */ jsx(Alert, { type: "warning", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, className: "mb-12", children: message }), {
+    warning: (message, options) => toast.custom((t) => /* @__PURE__ */ jsx(Alert, { type: "warning", isToast: !0, isDismissible: options == null ? void 0 : options.isDismissible, autoClose: !(options != null && options.isDismissible), autoCloseDelay: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION, onClose: () => toast.dismiss(t.id), className: "mb-12", children: message }), {
       id: options == null ? void 0 : options.id,
-      duration: (options == null ? void 0 : options.duration) ?? DEFAULT_DURATION,
+      duration: 1 / 0,
       position: (options == null ? void 0 : options.position) ?? DEFAULT_POSITION
     }),
     loading: toast.loading,

package/dist/hooks/useUserPreferences/index.d.ts

@@ -0,0 +1 @@
+export { default, useUserPreferences } from './useUserPreferences';

package/dist/hooks/useUserPreferences/useUserPreferences.d.ts

@@ -0,0 +1,9 @@
+export declare const USER_PREFERENCES_QUERY_KEY: string[];
+export declare function useUserPreferences<T extends Record<string, any> = Record<string, any>>(): {
+    preferences: T | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<T, Error>>;
+    savePreferences: (preferences: T) => Promise<T>;
+};
+export default useUserPreferences;

package/dist/hooks/useUserPreferences/useUserPreferences.js

@@ -0,0 +1,40 @@
+import { odeServices } from "@edifice.io/client";
+import { useQueryClient, useQuery, queryOptions, useMutation } from "@tanstack/react-query";
+const USER_PREFERENCES_QUERY_KEY = ["user", "preferences"];
+function useUserPreferences() {
+  const queryClient = useQueryClient(), {
+    data: preferences,
+    isLoading,
+    isError,
+    refetch
+  } = useQuery(queryOptions({
+    queryKey: USER_PREFERENCES_QUERY_KEY,
+    queryFn: () => odeServices.conf().getUserPreferences(),
+    staleTime: 15e3
+  })), mutation = useMutation({
+    mutationFn: (preferences2) => odeServices.conf().saveUserPreferences(preferences2),
+    onMutate: async (preferences2) => {
+      queryClient.setQueryData(USER_PREFERENCES_QUERY_KEY, preferences2);
+    },
+    onError: () => {
+      queryClient.invalidateQueries({
+        queryKey: USER_PREFERENCES_QUERY_KEY
+      });
+    },
+    onSuccess: (preferences2) => {
+      queryClient.setQueryData(USER_PREFERENCES_QUERY_KEY, preferences2);
+    }
+  });
+  return {
+    preferences,
+    isLoading,
+    isError,
+    refetch,
+    savePreferences: (preferences2) => mutation.mutateAsync(preferences2)
+  };
+}
+export {
+  USER_PREFERENCES_QUERY_KEY,
+  useUserPreferences as default,
+  useUserPreferences
+};

package/dist/hooks/useZendeskGuide/useZendeskGuide.d.ts

@@ -1,2 +1,16 @@
-/** Add Zendesk Guide  */
-export default function useZendeskGuide(): null;
+export interface UseZendeskGuideAPI {
+    /** True once the widget script is loaded and configured. */
+    isReady: boolean;
+    /** True while the widget panel is open. */
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+}
+/**
+ * Add Zendesk Guide
+ *
+ * @param headerColor Overrides the widget panel's theme color. Can change
+ * across renders (e.g. once resolved from async platform config) — the
+ * widget is updated in place, no need to keep it stable.
+ */
+export default function useZendeskGuide(headerColor?: string): UseZendeskGuideAPI;

package/dist/hooks/useZendeskGuide/useZendeskGuide.js

@@ -5,7 +5,7 @@ import { useEdificeTheme } from "../../providers/EdificeThemeProvider/EdificeThe
 import useUser from "../useUser/useUser.js";
 import useIsAdml from "../useIsAdml/useIsAdml.js";
 import useHasWorkflow from "../useHasWorkflow/useHasWorkflow.js";
-function useZendeskGuide() {
+function useZendeskGuide(headerColor) {
   const {
     currentLanguage
   } = useEdificeClient(), {
@@ -14,7 +14,13 @@ function useZendeskGuide() {
     isAdml
   } = useIsAdml(), {
     theme
-  } = useEdificeTheme(), isMobileView = window.innerWidth <= 768, hasSupportWorkflow = useHasWorkflow("net.atos.entng.support.controllers.DisplayController|view"), [locationPathname, setLocationPathname] = useState(""), [dataModule, setDataModule] = useState(void 0), setZendeskGuideLabels = () => {
+  } = useEdificeTheme(), isMobileView = window.innerWidth <= 768, hasSupportWorkflow = useHasWorkflow("net.atos.entng.support.controllers.DisplayController|view"), [locationPathname, setLocationPathname] = useState(""), [dataModule, setDataModule] = useState(void 0), [isReady, setIsReady] = useState(!1), [isOpen, setIsOpen] = useState(!1), open = () => {
+    var _a;
+    (_a = window.zE) == null || _a.call(window, "webWidget", "open");
+  }, close = () => {
+    var _a;
+    (_a = window.zE) == null || _a.call(window, "webWidget", "close");
+  }, setZendeskGuideLabels = () => {
     const modulePathnameSplit = locationPathname.split("/");
     let moduleLabel = "", labels = "";
     if (dataModule != null && dataModule.labels && Object.keys(dataModule == null ? void 0 : dataModule.labels).length > 0 && modulePathnameSplit.length > 1) {
@@ -33,8 +39,40 @@ function useZendeskGuide() {
   return useEffect(() => {
     window.location.pathname !== locationPathname && setLocationPathname(window.location.pathname), !(dataModule === void 0 || Object.keys(dataModule).length === 0) && setZendeskGuideLabels();
   }, [window.location.pathname, dataModule]), useEffect(() => {
-    document.getElementById("ze-snippet") || hasSupportWorkflow === void 0 || (async () => {
-      const zendeskGuideConfig = await odeServices.http().get("/zendeskGuide/config");
+    const registerWidgetHandlers = () => {
+      window.zE("webWidget:on", "open", function() {
+        setIsOpen(!0), hasSupportWorkflow && window.zE("webWidget", "updateSettings", {
+          webWidget: {
+            contactForm: {
+              suppress: !1
+            }
+          }
+        });
+      }), window.zE("webWidget:on", "close", function() {
+        setIsOpen(!1);
+      }), window.zE("webWidget:on", "userEvent", function(ref) {
+        const category = ref.category, action = ref.action, properties = ref.properties;
+        action === "Contact Form Shown" && category === "Zendesk Web Widget" && properties && properties.name === "contact-form" && hasSupportWorkflow && (window.zE("webWidget", "updateSettings", {
+          webWidget: {
+            contactForm: {
+              suppress: !0
+            }
+          }
+        }), window.zE("webWidget", "close"), window.open("/support/tickets/new", "_blank"));
+      });
+    };
+    if (document.getElementById("ze-snippet")) {
+      window.zE && (registerWidgetHandlers(), setIsReady(!0));
+      return;
+    }
+    hasSupportWorkflow !== void 0 && (async () => {
+      let zendeskGuideConfig;
+      try {
+        zendeskGuideConfig = await odeServices.http().get("/zendeskGuide/config");
+      } catch (error) {
+        console.warn("[useZendeskGuide] Failed to fetch the support widget config from `/zendeskGuide/config` — the widget (and HelpZone's button) won't show up. If you're running a local dev server, check that `/zendeskGuide` is proxied to your backend in your app's Vite dev proxy config.", error);
+        return;
+      }
       if (zendeskGuideConfig && zendeskGuideConfig.key && zendeskGuideConfig.key !== "") {
         const scriptZendesk = document.createElement("script");
         scriptZendesk.id = "ze-snippet", scriptZendesk.src = `https://static.zdassets.com/ekr/snippet.js?key=${zendeskGuideConfig.key}`, document.body.appendChild(scriptZendesk).onload = () => {
@@ -45,7 +83,7 @@ function useZendeskGuide() {
           }), Object.keys(zendeskGuideConfig.module).length > 0 && setDataModule(zendeskGuideConfig.module), window.zE("webWidget", "show"), window.zE("webWidget", "updateSettings", {
             webWidget: {
               color: {
-                theme: zendeskGuideConfig.color || "#ffc400"
+                theme: headerColor || zendeskGuideConfig.color || "#ffc400"
               },
               zIndex: 3,
               launcher: {
@@ -74,28 +112,24 @@ function useZendeskGuide() {
                 }
               }
             });
-          }), window.zE("webWidget:on", "open", function() {
-            hasSupportWorkflow && window.zE("webWidget", "updateSettings", {
-              webWidget: {
-                contactForm: {
-                  suppress: !1
-                }
-              }
-            });
-          }), window.zE("webWidget:on", "userEvent", function(ref) {
-            const category = ref.category, action = ref.action, properties = ref.properties;
-            action === "Contact Form Shown" && category === "Zendesk Web Widget" && properties && properties.name === "contact-form" && hasSupportWorkflow && (window.zE("webWidget", "updateSettings", {
-              webWidget: {
-                contactForm: {
-                  suppress: !0
-                }
-              }
-            }), window.zE("webWidget", "close"), window.open("/support/tickets/new", "_blank"));
-          });
+          }), registerWidgetHandlers(), setIsReady(!0);
         };
       }
     })();
-  }, [hasSupportWorkflow]), null;
+  }, [hasSupportWorkflow]), useEffect(() => {
+    !isReady || headerColor === void 0 || window.zE("webWidget", "updateSettings", {
+      webWidget: {
+        color: {
+          theme: headerColor
+        }
+      }
+    });
+  }, [headerColor, isReady]), {
+    isReady,
+    isOpen,
+    open,
+    close
+  };
 }
 export {
   useZendeskGuide as default