@edifice.io/react 2.6.5 → 2.6.6-develop-b2school.20260922101258

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

@@ -12,8 +12,13 @@ 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";
 export {
   Favorites,
@@ -23,6 +28,8 @@ export {
   default4 as LastInfos,
   LastInfosContainer,
   LastInfosList,
+  LinkForm,
+  MAX_USEFUL_LINKS,
   default5 as MessageFlash,
   default6 as MessageFlashList,
   MessageFlashListContainer,
@@ -31,6 +38,10 @@ export {
   NotificationListContainer,
   default9 as SchoolSpace,
   SchoolSpaceContainer,
+  UsefulLinks,
+  UsefulLinksContainer,
+  UsefulLinksModal,
   default10 as UserSpace,
-  UserSpaceContainer
+  UserSpaceContainer,
+  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/useUploadFiles/index.d.ts

@@ -1 +1,2 @@
 export { default as useUploadFiles } from './useUploadFiles';
+export type { UploadSourceFileInfo } from './useUploadFiles';

package/dist/hooks/useUploadFiles/useUploadFiles.d.ts

@@ -1,6 +1,16 @@
 import { WorkspaceElement, WorkspaceVisibility } from '@edifice.io/client';
+/**
+ * Snapshot of a source file taken at upload time, so the upload result can be
+ * re-ordered later on against the original file metadata.
+ */
+export interface UploadSourceFileInfo {
+    /** Original file name. */
+    name: string;
+    /** `File.lastModified` of the source file (ms since epoch). */
+    lastModified: number;
+}
 declare const useUploadFiles: ({ handleOnChange, visibility, application, }: {
-    handleOnChange: (uploadedFiles: WorkspaceElement[]) => void;
+    handleOnChange: (uploadedFiles: WorkspaceElement[], sourceFilesInfo: Record<string, UploadSourceFileInfo>) => void;
     visibility?: WorkspaceVisibility;
     application?: string;
 }) => {

package/dist/hooks/useUploadFiles/useUploadFiles.js

@@ -1,4 +1,4 @@
-import { useState, useCallback, useEffect } from "react";
+import { useState, useRef, useCallback, useEffect } from "react";
 import { ImageResizer, addTimestampToImageUrl } from "@edifice.io/utilities";
 import { useDropzoneContext } from "../../components/Dropzone/DropzoneContext.js";
 import useWorkspaceFile from "../useWorkspaceFile/useWorkspaceFile.js";
@@ -8,7 +8,7 @@ const useUploadFiles = ({
   visibility,
   application
 }) => {
-  const [uploadedFiles, setUploadedFiles] = useState([]), [editingImage, setEditingImage] = useState(void 0), {
+  const [uploadedFiles, setUploadedFiles] = useState([]), sourceFilesInfoRef = useRef({}), [editingImage, setEditingImage] = useState(void 0), {
     files,
     deleteFile,
     replaceFileAt,
@@ -34,7 +34,10 @@ const useUploadFiles = ({
         } catch (err) {
           console.error(err);
         }
-      !resource && !replacement && (resource = await uploadFile(file)), resource ? setUploadedFiles((prevFiles) => [...prevFiles, resource]) : resetInputValue();
+      !resource && !replacement && (resource = await uploadFile(file)), resource ? (resource._id && (sourceFilesInfoRef.current[resource._id] = {
+        name: file.name,
+        lastModified: file.lastModified
+      }), setUploadedFiles((prevFiles) => [...prevFiles, resource])) : resetInputValue();
     });
   }, [uploadAlternateFile, uploadFile, replaceFileAt]);
   useEffect(() => {
@@ -47,15 +50,17 @@ const useUploadFiles = ({
     newFiles.forEach((file) => file && setUploadStatus(file, "idle")), tryUploading(newFiles);
   }, [files, uploadedFiles, getUploadStatus, setUploadStatus, tryUploading]), useEffect(() => {
     const sortedUploadedFiles = sortUploadedFiles(files, uploadedFiles);
-    handleOnChange(sortedUploadedFiles);
+    handleOnChange(sortedUploadedFiles, {
+      ...sourceFilesInfoRef.current
+    });
   }, [uploadedFiles]);
   const sortUploadedFiles = (filesArray, uploadedFilesArray) => {
-    const orderMap = filesArray.reduce((acc, item, index) => (acc[item.name] = index, acc), {});
-    return uploadedFilesArray.sort((a, b) => orderMap[a.name] - orderMap[b.name]);
+    const orderMap = filesArray.reduce((acc, item, index) => (item.name in acc || (acc[item.name] = index), acc), {});
+    return [...uploadedFilesArray].sort((a, b) => (orderMap[a.name] ?? Number.MAX_SAFE_INTEGER) - (orderMap[b.name] ?? Number.MAX_SAFE_INTEGER));
   };
   async function removeFile(file) {
     const resource = uploadedFiles.find((uploadedFile) => uploadedFile.name === file.name);
-    resource && (await remove(resource), clearUploadStatus(file), setUploadedFiles((prevFiles) => prevFiles.filter((prevFile) => prevFile.name !== (resource == null ? void 0 : resource.name)))), deleteFile(file), resetInputValue();
+    resource && (await remove(resource), clearUploadStatus(file), resource._id && delete sourceFilesInfoRef.current[resource._id], setUploadedFiles((prevFiles) => prevFiles.filter((prevFile) => prevFile.name !== (resource == null ? void 0 : resource.name)))), deleteFile(file), resetInputValue();
   }
   async function updateImage({
     blob,

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,14 @@
-/** 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.
+ */
+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,8 @@ 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: zendeskGuideConfig.color || "#ffc400",
+                header: headerColor
               },
               zIndex: 3,
               launcher: {
@@ -74,28 +113,16 @@ 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]), {
+    isReady,
+    isOpen,
+    open,
+    close
+  };
 }
 export {
   useZendeskGuide as default