@edifice.io/react 2.6.3 → 2.6.4-develop-integration-demo.20260901111601

package/dist/components/Badge/Badge.d.ts

@@ -6,6 +6,11 @@ export type NotificationBadgeVariant = {
     type: 'notification';
     level: 'success' | 'warning' | 'danger' | 'info';
 };
+/** Badge variant : status */
+export type StatusBadgeVariant = {
+    type: 'status';
+    level: 'validate' | 'success' | 'warning' | 'danger' | 'info';
+};
 /** Badge variant : content */
 export type ContentBadgeVariant = {
     type: 'content';
@@ -49,7 +54,7 @@ export type AppVersionBadgeVariant = {
     color?: string;
     app?: IWebApp;
 };
-export type BadgeVariants = NotificationBadgeVariant | ContentBadgeVariant | ProfileBadgeVariant | ChipBadgeVariant | LinkBadgeVariant | AppVersionBadgeVariant;
+export type BadgeVariants = NotificationBadgeVariant | StatusBadgeVariant | ContentBadgeVariant | ProfileBadgeVariant | ChipBadgeVariant | LinkBadgeVariant | AppVersionBadgeVariant;
 export interface BadgeProps extends React.ComponentPropsWithRef<'span'> {
     /**
      * Badge variant : notification, link or profile (Teacher|Student|Relative|Personnel)

package/dist/components/Badge/Badge.js

@@ -21,7 +21,7 @@ const Badge = /* @__PURE__ */ forwardRef(({
     const colorAppClassName = getIconClass(variant.app), backgroundLightAppClassName = getBackgroundLightIconClass(variant.app), borderAppClassName = getBorderIconClass(variant.app);
     appVersionBadgeColorClassName = `${colorAppClassName} ${backgroundLightAppClassName} ${borderAppClassName}`;
   }
-  const classes = clsx("badge rounded-pill", (variant.type === "content" || variant.type === "user") && "background" in variant ? "bg-gray-200" : (variant.type === "content" || variant.type === "user") && !("background" in variant) ? "border border-0" : "", variant.type === "content" && `text-${variant.level}`, variant.type === "notification" && `badge-notification bg-${variant.level} text-light border border-0`, variant.type === "user" && `badge-profile-${variant.profile.toLowerCase()}`, variant.type === "link" && "badge-link border border-0", variant.type === "chip" && "bg-gray-200", variant.type === "appVersion" && appVersionBadgeColorClassName, className);
+  const classes = clsx("badge rounded-pill", (variant.type === "content" || variant.type === "user") && "background" in variant ? "bg-gray-200" : (variant.type === "content" || variant.type === "user") && !("background" in variant) ? "border border-0" : "", variant.type === "content" && `text-${variant.level}`, variant.type === "notification" && `badge-notification bg-${variant.level} text-light border border-0`, variant.type === "status" && `badge-status badge-status-${variant.level} caption fw-normal`, variant.type === "user" && `badge-profile-${variant.profile.toLowerCase()}`, variant.type === "link" && "badge-link border border-0", variant.type === "chip" && "bg-gray-200", variant.type === "appVersion" && appVersionBadgeColorClassName, className);
   return /* @__PURE__ */ jsxs("span", { ref, className: classes, ...restProps, children: [
     variant.type === "chip" && /* @__PURE__ */ jsx("div", { className: "d-flex fw-800 align-items-center", children }),
     variant.type === "appVersion" && (children ?? "BÊTA"),

package/dist/components/Layout/components/Header.js

@@ -5,7 +5,6 @@ import { useEdificeClient } from "../../../providers/EdificeClientProvider/Edifi
 import { useEdificeTheme } from "../../../providers/EdificeThemeProvider/EdificeThemeProvider.hook.js";
 import SvgIconRafterDown from "../../../modules/icons/components/IconRafterDown.js";
 import SvgIconCommunities from "../../../modules/icons/components/nav/IconCommunities.js";
-import SvgIconCommunity from "../../../modules/icons/components/nav/IconCommunity.js";
 import SvgIconDisconnect from "../../../modules/icons/components/nav/IconDisconnect.js";
 import SvgIconHome from "../../../modules/icons/components/nav/IconHome.js";
 import SvgIconMyApps from "../../../modules/icons/components/nav/IconMyApps.js";
@@ -67,7 +66,6 @@ const Header = ({
     userAvatar,
     userName,
     welcomeUser,
-    communityWorkflow,
     communitiesWorkflow,
     conversationWorflow,
     searchWorkflow,
@@ -176,10 +174,6 @@ const Header = ({
       /* @__PURE__ */ jsx(NavItem, { children: /* @__PURE__ */ jsxs("div", { className: "dropdown", children: [
         /* @__PURE__ */ jsx("button", { className: "nav-link btn btn-naked d-md-none", type: "button", "aria-controls": "dropdown-navbar", "aria-expanded": !isCollapsed, "aria-label": t("navbar.open.menu"), onClick: toggleCollapsedNav, children: /* @__PURE__ */ jsx(SvgIconRafterDown, { className: "icon rafter-down", width: "20", height: "20", color: "#fff" }) }),
         /* @__PURE__ */ jsxs("ul", { className: `dropdown-menu dropdown-menu-end ${isCollapsed ? "" : "show"}`, id: "dropdown-navbar", children: [
-          communityWorkflow && /* @__PURE__ */ jsx(NavItem, { children: /* @__PURE__ */ jsxs("a", { href: "/community", className: "nav-link dropdown-item", children: [
-            /* @__PURE__ */ jsx(SvgIconCommunity, { className: "icon community" }),
-            /* @__PURE__ */ jsx("span", { className: "nav-text", children: t("navbar.community") })
-          ] }) }),
           communitiesWorkflow && /* @__PURE__ */ jsx(NavItem, { children: /* @__PURE__ */ jsxs("a", { href: "/communities", className: "nav-link dropdown-item", children: [
             /* @__PURE__ */ jsx(SvgIconCommunities, { className: "icon communities" }),
             /* @__PURE__ */ jsx("span", { className: "nav-text", children: t("navbar.community") })

package/dist/components/Layout/components/NavLink.d.ts

@@ -21,4 +21,4 @@ export interface NavLinkProps<T> {
      */
     button?: boolean;
 }
-export declare function NavLink({ link, className, children, translate, ...restProps }: NavLinkProps<string>): import("react/jsx-runtime").JSX.Element;
+export declare function NavLink({ link, className, children, translate, button, ...restProps }: NavLinkProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/components/Layout/components/NavLink.js

@@ -6,6 +6,8 @@ function NavLink({
   className,
   children,
   translate,
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  button,
   ...restProps
 }) {
   const classes = clsx("nav-link", className);

package/dist/components/Layout/hooks/useHeader.js

@@ -14,7 +14,7 @@ function useHeader({
     t
   } = useTranslation(), title = t(appCode), [isCollapsed, setIsCollapsed] = useState(!0), [appsRef, isAppsHovered] = useHover(), popoverAppsId = useId(), popoverSearchId = useId(), userAvatar = avatar, userName = user == null ? void 0 : user.username, welcomeUser = t("welcome", {
     username: user == null ? void 0 : user.firstName
-  }), bookmarkedApps = useBookmark(), communityWorkflow = useHasWorkflow("net.atos.entng.community.controllers.CommunityController|view"), communitiesWorkflow = useHasWorkflow("community.access"), conversationWorflow = useHasWorkflow("org.entcore.conversation.controllers.ConversationController|view"), searchWorkflow = useHasWorkflow("fr.openent.searchengine.controllers.SearchEngineController|view"), toggleCollapsedNav = useCallback(() => {
+  }), bookmarkedApps = useBookmark(), communitiesWorkflow = useHasWorkflow("community.access"), conversationWorflow = useHasWorkflow("org.entcore.conversation.controllers.ConversationController|view"), searchWorkflow = useHasWorkflow("fr.openent.searchengine.controllers.SearchEngineController|view"), toggleCollapsedNav = useCallback(() => {
     setIsCollapsed(!isCollapsed);
   }, [isCollapsed]);
   return useMemo(() => ({
@@ -27,13 +27,12 @@ function useHeader({
     userAvatar,
     userName,
     welcomeUser,
-    communityWorkflow,
     communitiesWorkflow,
     conversationWorflow,
     searchWorkflow,
     isCollapsed,
     toggleCollapsedNav
-  }), [appsRef, bookmarkedApps, communitiesWorkflow, communityWorkflow, conversationWorflow, isAppsHovered, isCollapsed, popoverAppsId, popoverSearchId, searchWorkflow, title, toggleCollapsedNav, userAvatar, userName, welcomeUser]);
+  }), [appsRef, bookmarkedApps, communitiesWorkflow, conversationWorflow, isAppsHovered, isCollapsed, popoverAppsId, popoverSearchId, searchWorkflow, title, toggleCollapsedNav, userAvatar, userName, welcomeUser]);
 }
 export {
   useHeader as default

package/dist/components/PageLayout/PageLayout.js

@@ -8,6 +8,7 @@ import PageLayoutOverlay from "./components/PageLayoutOverlay.js";
 import PageLayoutSidebarLeft from "./components/PageLayoutSidebarLeft.js";
 import PageLayoutSidebarRight from "./components/PageLayoutSidebarRight.js";
 import { PageLayoutContext } from "./PageLayoutContext.js";
+import useZendeskGuide from "../../hooks/useZendeskGuide/useZendeskGuide.js";
 function analyzeChildren(children) {
   let hasLeftSidebar = !1, hasRightSidebar = !1, breadcrumb = null, overlay = null;
   const headerChildren = [], mainChildren = [];
@@ -58,7 +59,9 @@ const Root = ({
     variant,
     scrollMode,
     noPadding
-  }), [variant, scrollMode, noPadding]), {
+  }), [variant, scrollMode, noPadding]);
+  useZendeskGuide();
+  const {
     hasLeftSidebar,
     hasRightSidebar,
     breadcrumb,

package/dist/homepage.js

@@ -1,13 +1,17 @@
-import { default as default2 } from "./modules/homepage/components/Header/Header.js";
-import { default as default3 } from "./modules/homepage/components/HomeCard/HomeCard.js";
-import { default as default4 } from "./modules/homepage/components/LastInfos/LastInfos.js";
-import { default as default5 } from "./modules/homepage/components/MessageFlashList/MessageFlash.js";
-import { default as default6 } from "./modules/homepage/components/MessageFlashList/MessageFlashList.js";
-import { default as default7 } from "./modules/homepage/components/Notifications/NotificationItem.js";
-import { default as default8 } from "./modules/homepage/components/Notifications/NotificationList.js";
+import { default as default2 } from "./modules/homepage/components/Communities/Communities.js";
+import { default as default3 } from "./modules/homepage/components/Communities/CommunityItem.js";
+import { default as default4 } from "./modules/homepage/components/Communities/CommunitiesSkeleton.js";
+import { default as default5 } from "./modules/homepage/components/Header/Header.js";
+import { default as default6 } from "./modules/homepage/components/HomeCard/HomeCard.js";
+import { default as default7 } from "./modules/homepage/components/LastInfos/LastInfos.js";
+import { default as default8 } from "./modules/homepage/components/MessageFlashList/MessageFlash.js";
+import { default as default9 } from "./modules/homepage/components/MessageFlashList/MessageFlashList.js";
+import { default as default10 } from "./modules/homepage/components/Notifications/NotificationItem.js";
+import { default as default11 } from "./modules/homepage/components/Notifications/NotificationList.js";
 import { NotificationListContainer } from "./modules/homepage/components/Notifications/NotificationListContainer.js";
-import { default as default9 } from "./modules/homepage/components/SchoolSpace/SchoolSpace.js";
-import { default as default10 } from "./modules/homepage/components/UserSpace/UserSpace.js";
+import { default as default12 } from "./modules/homepage/components/SchoolSpace/SchoolSpace.js";
+import { default as default13 } from "./modules/homepage/components/UserSpace/UserSpace.js";
+import { CommunitiesContainer } from "./modules/homepage/components/Communities/CommunitiesContainer.js";
 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";
@@ -15,22 +19,32 @@ import { LastInfosList } from "./modules/homepage/components/LastInfos/LastInfos
 import { MessageFlashListContainer } from "./modules/homepage/components/MessageFlashList/MessageFlashListContainer.js";
 import { SchoolSpaceContainer } from "./modules/homepage/components/SchoolSpace/SchoolSpaceContainer.js";
 import { UserSpaceContainer } from "./modules/homepage/components/UserSpace/UserSpaceContainer.js";
+import { childrenQueryKeys, childrenQueryOptions, useChildren } from "./modules/homepage/components/UserSpace/hooks/useChildren.js";
+import { useCommunities } from "./modules/homepage/components/Communities/useCommunities.js";
 export {
+  default2 as Communities,
+  CommunitiesContainer,
+  default3 as CommunitiesItem,
+  default4 as CommunitiesSkeleton,
   Favorites,
   FavoritesContainer,
-  default2 as Header,
-  default3 as HomeCard,
-  default4 as LastInfos,
+  default5 as Header,
+  default6 as HomeCard,
+  default7 as LastInfos,
   LastInfosContainer,
   LastInfosList,
-  default5 as MessageFlash,
-  default6 as MessageFlashList,
+  default8 as MessageFlash,
+  default9 as MessageFlashList,
   MessageFlashListContainer,
-  default7 as NotificationItem,
-  default8 as NotificationList,
+  default10 as NotificationItem,
+  default11 as NotificationList,
   NotificationListContainer,
-  default9 as SchoolSpace,
+  default12 as SchoolSpace,
   SchoolSpaceContainer,
-  default10 as UserSpace,
-  UserSpaceContainer
+  default13 as UserSpace,
+  UserSpaceContainer,
+  childrenQueryKeys,
+  childrenQueryOptions,
+  useChildren,
+  useCommunities
 };

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 | undefined>;
+export default function useClickOutside<T extends HTMLElement = any>(handler: () => void, events?: string[] | null, nodes?: Array<HTMLElement | null>): import('react').MutableRefObject<T | null>;

package/dist/hooks/useClickOutside/useClickOutside.js

@@ -1,7 +1,7 @@
 import { useRef, useEffect } from "react";
 const DEFAULT_EVENTS = ["mousedown", "touchstart"];
 function useClickOutside(handler, events, nodes) {
-  const ref = useRef();
+  const ref = useRef(null);
   return useEffect(() => {
     const listener = (event) => {
       const {

package/dist/modules/editor/test-utils/createTestEditor.d.ts

@@ -0,0 +1,10 @@
+import { Editor, EditorOptions, Extensions } from '@tiptap/core';
+/**
+ * Builds a real, headless (uncoupled from React) tiptap `Editor` for
+ * component specs that need genuine ProseMirror state - selection, commands,
+ * `isActive` - rather than a hand-rolled mock. Callers should call
+ * `.destroy()` in `afterEach` to avoid leaking editor instances across tests.
+ */
+export declare const createTestEditor: (overrides?: {
+    extensions?: Extensions;
+} & Partial<EditorOptions>) => Editor;

package/dist/modules/homepage/components/Communities/Communities.js

@@ -0,0 +1,32 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import illuCommunities from "@edifice.io/bootstrap/dist/images/homepage/illu-communities.svg";
+import { useTranslation } from "react-i18next";
+import SvgIconArrowRight from "../../../icons/components/IconArrowRight.js";
+import CommunityItem from "./CommunityItem.js";
+import HomeCard from "../HomeCard/HomeCard.js";
+import Flex from "../../../../components/Flex/Flex.js";
+import Image from "../../../../components/Image/Image.js";
+const Communities = ({
+  communitiesList = [],
+  handleActionClick
+}) => {
+  const {
+    t
+  } = useTranslation();
+  return /* @__PURE__ */ jsxs(HomeCard, { variant: "primary", children: [
+    /* @__PURE__ */ jsx(HomeCard.Header, { actionLabel: communitiesList.length > 0 ? t("homepage.widget.communities.actionLabel.seeMore", "Voir plus") : t("homepage.widget.communities.actionLabel.create", "Créer une communauté"), actionRightIcon: /* @__PURE__ */ jsx(SvgIconArrowRight, {}), onActionClick: handleActionClick, title: t("homepage.widget.communities.title", "Communautés") }),
+    /* @__PURE__ */ jsx(HomeCard.Content, { children: /* @__PURE__ */ jsx(Flex, { gap: "16", children: communitiesList.length > 0 ? communitiesList.map((community, index) => /* @__PURE__ */ jsx(CommunityItem, { title: community.title, communityImage: community.communityImage, onActionClick: community.onActionClick, nbNotifications: community.nbNotifications }, index)) : /* @__PURE__ */ jsxs("div", { className: "communities-empty", children: [
+      /* @__PURE__ */ jsx(Image, { src: illuCommunities, alt: "", "aria-hidden": "true", style: {
+        width: 80,
+        height: 80
+      } }),
+      /* @__PURE__ */ jsxs("div", { className: "communities-empty-content", children: [
+        /* @__PURE__ */ jsx("p", { className: "communities-empty-title", children: t("homepage.communities.subtitle", "Créez votre première communauté pour animer votre classe !") }),
+        /* @__PURE__ */ jsx("p", { className: "communities-empty-description", children: t("homepage.communities.description", "Vous pouvez centraliser et organiser les documents et les ressources pour vos élèves.") })
+      ] })
+    ] }) }) })
+  ] });
+};
+export {
+  Communities as default
+};

package/dist/modules/homepage/components/Communities/CommunitiesContainer.js

@@ -0,0 +1,23 @@
+import { jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import Communities from "./Communities.js";
+import CommunitiesSkeleton from "./CommunitiesSkeleton.js";
+import { useCommunities } from "./useCommunities.js";
+function CommunitiesContainer({
+  onCommunityClick,
+  onHeaderActionClick
+}) {
+  const {
+    communities,
+    isLoading,
+    error
+  } = useCommunities(), mappedCommunities = useMemo(() => communities.map((community) => ({
+    title: community.title,
+    communityImage: community.image ?? "",
+    onActionClick: () => onCommunityClick == null ? void 0 : onCommunityClick(community)
+  })), [communities, onCommunityClick]);
+  return isLoading ? /* @__PURE__ */ jsx(CommunitiesSkeleton, {}) : error ? "An error occurred while loading communities." : /* @__PURE__ */ jsx(Communities, { communitiesList: mappedCommunities, handleActionClick: onHeaderActionClick });
+}
+export {
+  CommunitiesContainer
+};

package/dist/modules/homepage/components/Communities/CommunitiesSkeleton.js

@@ -0,0 +1,32 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import HomeCard from "../HomeCard/HomeCard.js";
+import Flex from "../../../../components/Flex/Flex.js";
+import TextSkeleton from "../../../../components/Skeleton/TextSkeleton.js";
+import ButtonSkeleton from "../../../../components/Skeleton/ButtonSkeleton.js";
+const primaryTitleWidths = ["80%", "64%", "88%", "72%"], secondaryTitleWidths = ["56%", "44%", "60%", "48%"], CommunitiesSkeleton = () => /* @__PURE__ */ jsxs(HomeCard, { variant: "primary", "data-testid": "communities-skeleton", children: [
+  /* @__PURE__ */ jsxs(Flex, { align: "center", justify: "between", gap: "8", className: "home-card-header", children: [
+    /* @__PURE__ */ jsx(TextSkeleton, { size: "lg", className: "col-5" }),
+    /* @__PURE__ */ jsx(ButtonSkeleton, { "aria-hidden": "true", size: "sm", className: "px-24", color: "tertiary" })
+  ] }),
+  /* @__PURE__ */ jsx(HomeCard.Content, { children: /* @__PURE__ */ jsx(Flex, { gap: "16", children: primaryTitleWidths.map((primaryWidth, index) => /* @__PURE__ */ jsxs("div", { className: "communities-item", style: {
+    width: "25%"
+  }, "aria-hidden": "true", children: [
+    /* @__PURE__ */ jsx("div", { className: "communities-item-image placeholder rounded", style: {
+      display: "block",
+      aspectRatio: "1 / 1"
+    } }),
+    /* @__PURE__ */ jsxs(Flex, { direction: "column", gap: "4", className: "mt-8", children: [
+      /* @__PURE__ */ jsx("div", { style: {
+        width: primaryWidth,
+        alignSelf: "center"
+      }, children: /* @__PURE__ */ jsx(TextSkeleton, { className: "col-12", size: "sm" }) }),
+      /* @__PURE__ */ jsx("div", { style: {
+        width: secondaryTitleWidths[index],
+        alignSelf: "center"
+      }, children: /* @__PURE__ */ jsx(TextSkeleton, { className: "col-12", size: "sm" }) })
+    ] })
+  ] }, primaryWidth)) }) })
+] });
+export {
+  CommunitiesSkeleton as default
+};

package/dist/modules/homepage/components/Communities/CommunityItem.js

@@ -0,0 +1,27 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import clsx from "clsx";
+import Badge from "../../../../components/Badge/Badge.js";
+import Image from "../../../../components/Image/Image.js";
+const CommunityItem = ({
+  title,
+  communityImage,
+  nbNotifications,
+  onActionClick
+}) => {
+  const hasNotifications = (nbNotifications ?? 0) > 0;
+  return /* @__PURE__ */ jsxs("div", { role: "button", tabIndex: 0, onClick: onActionClick, className: clsx("communities-item", {
+    "communities-item-has-notifications": hasNotifications
+  }), style: {
+    width: "25%"
+  }, children: [
+    hasNotifications && /* @__PURE__ */ jsx(Badge, { className: "communities-item-badge", variant: {
+      level: "danger",
+      type: "notification"
+    }, children: nbNotifications }),
+    /* @__PURE__ */ jsx(Image, { className: "communities-item-image", src: communityImage, alt: title }),
+    /* @__PURE__ */ jsx("p", { className: "communities-item-title text-truncate text-truncate-2", children: title })
+  ] });
+};
+export {
+  CommunityItem as default
+};

package/dist/modules/homepage/components/Communities/useCommunities.d.ts

@@ -1,10 +1,14 @@
+export interface CommunityStats {
+    totalMembers: string;
+    memberCount: string;
+    adminCount: string;
+    communityId: number;
+}
 export interface CommunitiesModel {
     id: number | string;
     title: string;
-    communityImage?: string;
-    icon?: string;
-    nbNotifications?: number;
-    notifications?: number;
+    image?: string;
+    stats?: CommunityStats;
 }
 export declare function useCommunities(): {
     communities: CommunitiesModel[];

package/dist/modules/homepage/components/Communities/useCommunities.js

@@ -0,0 +1,25 @@
+import { odeServices } from "@edifice.io/client";
+import { useQuery, queryOptions } from "@tanstack/react-query";
+function useCommunities() {
+  const {
+    data,
+    isLoading,
+    error
+  } = useQuery(queryOptions({
+    queryKey: ["communities", "preview"],
+    queryFn: async () => {
+      const http = odeServices.http(), response = await http.get("/communities/api/communities?page=1&size=5&fields=stats");
+      if (http.isResponseError())
+        throw new Error(http.latestResponse.statusText);
+      return response.items;
+    }
+  }));
+  return {
+    communities: data ?? [],
+    isLoading,
+    error
+  };
+}
+export {
+  useCommunities
+};

package/dist/modules/homepage/components/UserSpace/hooks/useChildren.js

@@ -1,5 +1,5 @@
 import { odeServices } from "@edifice.io/client";
-import { useQuery, queryOptions } from "@tanstack/react-query";
+import { queryOptions, useQuery } from "@tanstack/react-query";
 const childrenQueryKeys = {
   all: (userId) => ["children", userId]
 };

package/dist/modules/homepage/components/UserSpace/index.d.ts

@@ -1,3 +1,4 @@
 export * from './UserSpace';
 export { default as UserSpace } from './UserSpace';
 export * from './UserSpaceContainer';
+export * from './hooks/useChildren';

package/dist/modules/homepage/components/index.d.ts

@@ -1,3 +1,4 @@
+export * from './Communities';
 export * from './Favorites';
 export * from './Header';
 export * from './HomeCard';

package/dist/modules/multimedia/testing/mediaHarness.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Doubles for the browser capture APIs the recorders rely on, none of which
+ * jsdom implements: `navigator.mediaDevices`, `MediaStream`, `MediaRecorder`,
+ * and the playback methods of `HTMLMediaElement`.
+ *
+ * Shared by the audio and the video recorder specs. The Web Audio doubles
+ * (`AudioContext`, `AudioWorkletNode`, `Worker`) sit in the second half of this
+ * file, behind `installWebAudioHarness`: only `useAudioRecorder` needs them,
+ * but both of its specs do.
+ */
+/** A track the component can stop to release the device. */
+export declare function fakeTrack(kind?: 'audio' | 'video'): MediaStreamTrack;
+/**
+ * `MediaStream` has to exist as a constructor, not just as a shape:
+ * <VideoRecorder> narrows with `srcObject instanceof MediaStream` before
+ * resetting it.
+ */
+export declare class FakeMediaStream {
+    id: string;
+    private tracks;
+    constructor(tracks?: MediaStreamTrack[]);
+    static created: number;
+    getTracks(): MediaStreamTrack[];
+}
+export type FakeMediaStreamInstance = FakeMediaStream & MediaStream;
+/** Records what the component asked of it, and lets a test push data back. */
+export declare class FakeMediaRecorder {
+    static instances: FakeMediaRecorder[];
+    /** Mime types rejected by `isTypeSupported`, to exercise the fallbacks. */
+    static unsupported: string[];
+    state: 'inactive' | 'recording' | 'paused';
+    ondataavailable: ((event: {
+        data: Blob;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    readonly stream: MediaStream;
+    readonly mimeType: string;
+    readonly start: import('vitest').Mock<(timeslice?: number) => void>;
+    readonly stop: import('vitest').Mock<() => void>;
+    readonly requestData: import('vitest').Mock<(...args: any[]) => any>;
+    timeslice?: number;
+    constructor(stream: MediaStream, options?: {
+        mimeType?: string;
+    });
+    static isTypeSupported(type: string): boolean;
+    /** Hands a chunk to the component, as the browser would every timeslice. */
+    emitData(blob: Blob): void;
+    emitError(event?: unknown): void;
+}
+export type MediaHarness = {
+    /** The stream handed over by `getUserMedia`. */
+    stream: FakeMediaStreamInstance;
+    getUserMedia: ReturnType<typeof vi.fn>;
+    enumerateDevices: ReturnType<typeof vi.fn>;
+    createObjectURL: ReturnType<typeof vi.fn>;
+    revokeObjectURL: ReturnType<typeof vi.fn>;
+    /** Every MediaRecorder built since the harness was installed. */
+    recorders: FakeMediaRecorder[];
+    /** The recorder currently in use, i.e. the last one built. */
+    recorder: () => FakeMediaRecorder;
+};
+export declare function videoInput(deviceId: string, label?: string): MediaDeviceInfo;
+export declare function audioInput(deviceId?: string): MediaDeviceInfo;
+/**
+ * Installs every double on the global scope. Call from `beforeEach`; the stubs
+ * are torn down by the `restoreMocks`/`unstubGlobals` handling of the runner,
+ * so nothing has to be undone by hand.
+ *
+ * @param devices what `enumerateDevices` should report
+ * @param stream the stream `getUserMedia` should resolve to
+ */
+export declare function installMediaHarness({ devices, stream, }?: {
+    devices?: MediaDeviceInfo[];
+    stream?: FakeMediaStreamInstance;
+}): MediaHarness;
+/**
+ * Replaces the playback methods jsdom leaves unimplemented, and makes
+ * `currentTime` writable so the components can rewind their media element.
+ */
+export declare function installMediaElementStubs(): void;
+export declare class FakeAudioWorkletNode {
+    readonly context: FakeAudioContext;
+    readonly processorName: string;
+    static instances: FakeAudioWorkletNode[];
+    readonly connect: import('vitest').Mock<(...args: any[]) => any>;
+    readonly disconnect: import('vitest').Mock<(...args: any[]) => any>;
+    /**
+     * The `MessagePort` is driven by hand: the hook subscribes with
+     * `addEventListener`, so the listeners are replayed by `emitSamples`.
+     */
+    readonly port: {
+        addEventListener: import('vitest').Mock<(...args: any[]) => any>;
+        removeEventListener: import('vitest').Mock<(...args: any[]) => any>;
+        close: import('vitest').Mock<(...args: any[]) => any>;
+        start: import('vitest').Mock<(...args: any[]) => any>;
+        postMessage: import('vitest').Mock<(...args: any[]) => any>;
+    };
+    constructor(context: FakeAudioContext, processorName: string);
+    /** Replays a block of samples, as the AudioWorkletProcessor would. */
+    emitSamples(inputs: unknown): void;
+}
+export declare class FakeAudioContext {
+    static instances: FakeAudioContext[];
+    /** Replaceable, to exercise the addModule failure path. */
+    static addModule: import('vitest').Mock<(moduleURL: string) => Promise<void>>;
+    readonly sampleRate: number;
+    /** Writable: the hook reads it to compute the elapsed recording time. */
+    currentTime: number;
+    readonly destination: {
+        connect: import('vitest').Mock<(...args: any[]) => any>;
+        disconnect: import('vitest').Mock<(...args: any[]) => any>;
+    };
+    readonly close: import('vitest').Mock<(...args: any[]) => any>;
+    readonly suspend: import('vitest').Mock<(...args: any[]) => any>;
+    readonly resume: import('vitest').Mock<(...args: any[]) => any>;
+    readonly createMediaStreamSource: import('vitest').Mock<() => {
+        connect: import('vitest').Mock<(...args: any[]) => any>;
+        disconnect: import('vitest').Mock<(...args: any[]) => any>;
+    }>;
+    readonly audioWorklet: {
+        addModule: (path: string) => Promise<void>;
+    };
+    constructor(options?: {
+        sampleRate?: number;
+    });
+}
+export declare class FakeWorker {
+    readonly url: string;
+    static instances: FakeWorker[];
+    readonly postMessage: import('vitest').Mock<(...args: any[]) => any>;
+    readonly terminate: import('vitest').Mock<(...args: any[]) => any>;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    constructor(url: string);
+    /** Answers the last `postMessage`, as the encoder worker would. */
+    emit(data: unknown): void;
+    /** The payload of the last message the hook sent, e.g. ['wav', …]. */
+    lastMessage(): any;
+}
+export type WebAudioHarness = {
+    /** The context opened by the current recording. */
+    context: () => FakeAudioContext;
+    /** The worklet node processing the current recording. */
+    workletNode: () => FakeAudioWorkletNode;
+    /** The encoder worker, created once on mount. */
+    worker: () => FakeWorker;
+    addModule: typeof FakeAudioContext.addModule;
+};
+/**
+ * Installs the Web Audio doubles. Combine with `installMediaHarness`, which
+ * provides `getUserMedia` and the blob URL factory the encoder result needs.
+ */
+export declare function installWebAudioHarness(): WebAudioHarness;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edifice.io/react",
-  "version": "2.6.3",
+  "version": "2.6.4-develop-integration-demo.20260901111601",
   "description": "Edifice React Library",
   "keywords": [
     "react",
@@ -140,9 +140,9 @@
     "swiper": "10.1.0",
     "ua-parser-js": "1.0.36",
     "zustand": "4.5.7",
-    "@edifice.io/bootstrap": "2.6.3",
-    "@edifice.io/tiptap-extensions": "2.6.3",
-    "@edifice.io/utilities": "2.6.3"
+    "@edifice.io/bootstrap": "2.6.4-develop-integration-demo.20260901111601",
+    "@edifice.io/utilities": "2.6.4-develop-integration-demo.20260901111601",
+    "@edifice.io/tiptap-extensions": "2.6.4-develop-integration-demo.20260901111601"
   },
   "devDependencies": {
     "@babel/plugin-transform-react-pure-annotations": "7.27.1",
@@ -173,8 +173,8 @@
     "vite": "5.4.14",
     "vite-plugin-dts": "4.5.4",
     "vite-tsconfig-paths": "5.1.4",
-    "@edifice.io/client": "2.6.3",
-    "@edifice.io/config": "2.6.3"
+    "@edifice.io/config": "2.6.4-develop-integration-demo.20260901111601",
+    "@edifice.io/client": "2.6.4-develop-integration-demo.20260901111601"
   },
   "peerDependencies": {
     "@react-spring/web": "9.7.5",

package/dist/modules/multimedia/LinkerCard/LinkerCard._.d.ts

@@ -1,8 +0,0 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
-import { default as LinkerCard } from './LinkerCard';
-declare const meta: Meta<typeof LinkerCard>;
-export default meta;
-type Story = StoryObj<typeof LinkerCard>;
-export declare const Base: Story;
-export declare const TimelineGenerator: Story;
-export declare const Blog: Story;

package/dist/modules/multimedia/UploadCard/UploadCard._.d.ts

@@ -1,9 +0,0 @@
-import { Meta, StoryObj } from '@storybook/react-vite';
-import { default as UploadCard } from './UploadCard';
-declare const meta: Meta<typeof UploadCard>;
-export default meta;
-type Story = StoryObj<typeof UploadCard>;
-export declare const Base: Story;
-export declare const IsLoading: Story;
-export declare const IsSuccess: Story;
-export declare const IsError: Story;