@azure/communication-react 1.15.0-beta.2 → 1.15.0

package/dist/dist-esm/react-components/src/components/MentionPopover.d.ts

@@ -1,121 +0,0 @@
-import React from 'react';
-/**
- * Props for {@link _MentionPopover}.
- *
- * @internal
- */
-export interface _MentionPopoverProps {
-    /**
-     * Array of mention suggestions used to populate the suggestion list
-     */
-    suggestions: Mention[];
-    /**
-     * Index of the currently focused suggestion, if any
-     */
-    activeSuggestionIndex?: number;
-    /**
-     * Optional string used as mention popover's title.
-     * @defaultValue `Suggestions`
-     */
-    title?: string;
-    /**
-     * Element to anchor the popover to.
-     */
-    target: React.RefObject<Element>;
-    /**
-     * When rendering the popover, where to position it relative to the target.
-     */
-    targetPositionOffset?: {
-        top: number;
-        left: number;
-    };
-    /**
-     * Where to display the suggestions relative to the target.
-     * @defaultValue `above`
-     */
-    location?: 'above' | 'below';
-    /**
-     * Callback called when a mention suggestion is selected.
-     */
-    onSuggestionSelected: (suggestion: Mention) => void;
-    /**
-     * Callback to invoke when the popover is dismissed
-     */
-    onDismiss?: () => void;
-    /**
-     * Optional callback to render an item of the mention suggestions list.
-     */
-    onRenderSuggestionItem?: (suggestion: Mention, onSuggestionSelected: (suggestion: Mention) => void, isActive: boolean) => JSX.Element;
-}
-/**
- * Options to lookup suggestions in the mention scenario.
- *
- * @beta
- */
-export interface MentionLookupOptions {
-    /**
-     * Optional string to set trigger keyword for mention a specific participant.
-     *
-     * @defaultValue `@`
-     */
-    trigger?: string;
-    /**
-     * Optional callback to fetch a list of mention suggestions base on the query.
-     */
-    onQueryUpdated: (query: string) => Promise<Mention[]>;
-    /**
-     * Optional callback to render an item of the mention suggestions list.
-     */
-    onRenderSuggestionItem?: (suggestion: Mention, onSuggestionSelected: (suggestion: Mention) => void, isActive: boolean) => JSX.Element;
-}
-/**
- * Options to display suggestions in the mention scenario.
- *
- * @beta
- */
-export interface MentionDisplayOptions {
-    /**
-     * Optional callback for customizing the mention renderer in a message thread.
-     */
-    onRenderMention?: (mention: Mention, defaultOnRender: (mention: Mention) => JSX.Element) => JSX.Element;
-}
-/**
- * Options to lookup suggestions and display mentions in the mention scenario.
- *
- * @beta
- */
-export type MentionOptions = {
-    lookupOptions?: MentionLookupOptions;
-    displayOptions?: MentionDisplayOptions;
-};
-/**
- * Mention's state, as reflected in the UI.
- *
- * @beta
- */
-export interface Mention {
-    /** ID of a mention */
-    id: string;
-    /** Display text of a mention */
-    displayText: string;
-    /** Optional React element to render an item icon of a mention suggestion */
-    icon?: JSX.Element;
-}
-/**
- * Strings of {@link _MentionPopover} that can be overridden.
- *
- * @beta
- */
-export interface MentionPopoverStrings {
-    /**
-     * Header text for MentionPopover
-     */
-    mentionPopoverHeader: string;
-}
-/**
- * Component to render a pop-up of mention suggestions.
- *
- * @internal
- */
-export declare const _MentionPopover: (props: _MentionPopoverProps) => JSX.Element;
-//# sourceMappingURL=MentionPopover.d.ts.map

package/dist/dist-esm/react-components/src/components/MentionPopover.js

@@ -1,123 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-import React, { useEffect, useRef, useState, useCallback } from 'react';
-import { Persona, PersonaSize, Stack, mergeStyles, useTheme } from '@fluentui/react';
-import { mergeClasses } from '@fluentui/react-components';
-import { mentionPopoverContainerStyle, headerStyleThemed, suggestionItemStackStyle, suggestionItemWrapperStyle, useSuggestionListStyle } from './styles/MentionPopover.style';
-/* @conditional-compile-remove(mention) */
-import { useIdentifiers } from '../identifiers';
-import { useLocale } from '../localization';
-import { useDefaultStackStyles } from './styles/Stack.style';
-/**
- * Component to render a pop-up of mention suggestions.
- *
- * @internal
- */
-export const _MentionPopover = (props) => {
-    const { suggestions, activeSuggestionIndex, title, target, targetPositionOffset, onRenderSuggestionItem, onSuggestionSelected, onDismiss, location } = props;
-    const theme = useTheme();
-    /* @conditional-compile-remove(mention) */
-    const ids = useIdentifiers();
-    const localeStrings = useLocale().strings;
-    const popoverRef = useRef();
-    const suggestionsListRef = useRef(null);
-    const [position, setPosition] = useState();
-    const [hoveredSuggestion, setHoveredSuggestion] = useState(undefined);
-    const suggestionListStyle = useSuggestionListStyle();
-    const defaultStackStyles = useDefaultStackStyles();
-    const dismissPopoverWhenClickingOutside = useCallback((e) => {
-        const target = e.target;
-        if (popoverRef.current && !popoverRef.current.contains(target)) {
-            onDismiss && onDismiss();
-        }
-    }, [onDismiss]);
-    useEffect(() => {
-        if (suggestionsListRef.current && activeSuggestionIndex !== undefined && activeSuggestionIndex >= 0) {
-            const selectedItem = suggestionsListRef.current.children[activeSuggestionIndex];
-            if (selectedItem) {
-                selectedItem.scrollIntoView({
-                    behavior: 'smooth',
-                    block: 'nearest'
-                });
-            }
-        }
-    }, [activeSuggestionIndex]);
-    useEffect(() => {
-        window && window.addEventListener('click', dismissPopoverWhenClickingOutside);
-        return () => {
-            window && window.removeEventListener('click', dismissPopoverWhenClickingOutside);
-        };
-    }, [dismissPopoverWhenClickingOutside]);
-    // Determine popover position
-    useEffect(() => {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        const rect = (_a = target === null || target === void 0 ? void 0 : target.current) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
-        const maxWidth = 200;
-        const finalPosition = {
-            maxWidth
-        };
-        // Figure out whether it will fit horizontally
-        const leftOffset = (_b = targetPositionOffset === null || targetPositionOffset === void 0 ? void 0 : targetPositionOffset.left) !== null && _b !== void 0 ? _b : 0;
-        if (leftOffset + maxWidth > ((_c = rect === null || rect === void 0 ? void 0 : rect.width) !== null && _c !== void 0 ? _c : 0)) {
-            finalPosition.right = ((_d = rect === null || rect === void 0 ? void 0 : rect.width) !== null && _d !== void 0 ? _d : 0) - leftOffset;
-        }
-        else {
-            finalPosition.left = leftOffset;
-        }
-        // Offset between cursor and mention popover
-        const verticalOffset = 4;
-        if (location === 'below') {
-            finalPosition.top = ((_e = rect === null || rect === void 0 ? void 0 : rect.height) !== null && _e !== void 0 ? _e : 0) + ((_f = targetPositionOffset === null || targetPositionOffset === void 0 ? void 0 : targetPositionOffset.top) !== null && _f !== void 0 ? _f : 0) + verticalOffset;
-        }
-        else {
-            // (location === 'above')
-            finalPosition.bottom = ((_g = rect === null || rect === void 0 ? void 0 : rect.height) !== null && _g !== void 0 ? _g : 0) - ((_h = targetPositionOffset === null || targetPositionOffset === void 0 ? void 0 : targetPositionOffset.top) !== null && _h !== void 0 ? _h : 0) + verticalOffset;
-        }
-        setPosition(finalPosition);
-    }, [location, target, targetPositionOffset]);
-    const handleOnKeyDown = useCallback((e) => {
-        switch (e.key) {
-            case 'Escape':
-                onDismiss && onDismiss();
-                break;
-            default:
-                break;
-        }
-    }, [onDismiss]);
-    const personaRenderer = useCallback((displayName) => {
-        const avatarOptions = {
-            text: displayName.trim(),
-            size: PersonaSize.size24,
-            initialsColor: theme.palette.neutralLight,
-            initialsTextColor: theme.palette.neutralSecondary,
-            showOverflowTooltip: false,
-            showUnknownPersonaCoin: false
-        };
-        return React.createElement(Persona, Object.assign({}, avatarOptions));
-    }, [theme]);
-    const defaultOnRenderSuggestionItem = useCallback((suggestion, onSuggestionSelected, active) => {
-        return React.createElement("div", { "data-is-focusable": true, "data-ui-id": ids.mentionSuggestionItem, key: suggestion.id, onClick: () => onSuggestionSelected(suggestion), onMouseEnter: () => setHoveredSuggestion(suggestion), onMouseLeave: () => setHoveredSuggestion(undefined), onKeyDown: e => {
-                handleOnKeyDown(e);
-            }, className: suggestionItemWrapperStyle(theme) },
-            React.createElement(Stack, { horizontal: true, className: suggestionItemStackStyle(theme, (hoveredSuggestion === null || hoveredSuggestion === void 0 ? void 0 : hoveredSuggestion.id) === suggestion.id, active) }, personaRenderer(suggestion.displayText)));
-    }, [handleOnKeyDown, theme, /* @conditional-compile-remove(mention) */
-        ids, hoveredSuggestion, personaRenderer]);
-    const getHeaderTitle = useCallback(() => {
-        if (title) {
-            return title;
-        }
-        /* @conditional-compile-remove(mention) */
-        return localeStrings.mentionPopover.mentionPopoverHeader;
-        return '';
-    }, [localeStrings, title]);
-    return React.createElement("div", { ref: popoverRef }, position && React.createElement(Stack, { "data-testid": 'mention-suggestion-list-container', className: mergeStyles({
-            maxHeight: 212,
-            maxWidth: position.maxWidth
-        }, mentionPopoverContainerStyle(theme), Object.assign(Object.assign({}, position), { position: 'absolute' })) },
-        React.createElement(Stack.Item, { styles: headerStyleThemed(theme), "aria-label": title }, getHeaderTitle()),
-        React.createElement("div", { className: mergeClasses(defaultStackStyles.root, suggestionListStyle.root), "data-ui-id": ids.mentionSuggestionList, ref: suggestionsListRef }, suggestions.map((suggestion, index) => {
-            const active = index === activeSuggestionIndex;
-            return onRenderSuggestionItem ? onRenderSuggestionItem(suggestion, onSuggestionSelected, active) : defaultOnRenderSuggestionItem(suggestion, onSuggestionSelected, active);
-        }))));
-};
-//# sourceMappingURL=MentionPopover.js.map

package/dist/dist-esm/react-components/src/components/MentionPopover.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MentionPopover.js","sourceRoot":"","sources":["../../../../../preprocess-dist/react-components/src/components/MentionPopover.tsx"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport React, { useEffect, useRef, useState, useCallback } from 'react';\nimport { Persona, PersonaSize, Stack, mergeStyles, useTheme } from '@fluentui/react';\nimport { mergeClasses } from '@fluentui/react-components';\nimport { mentionPopoverContainerStyle, headerStyleThemed, suggestionItemStackStyle, suggestionItemWrapperStyle, useSuggestionListStyle } from './styles/MentionPopover.style';\n/* @conditional-compile-remove(mention) */\nimport { useIdentifiers } from '../identifiers';\nimport { useLocale } from '../localization';\nimport { useDefaultStackStyles } from './styles/Stack.style';\n\n/**\n * Props for {@link _MentionPopover}.\n *\n * @internal\n */\nexport interface _MentionPopoverProps {\n  /**\n   * Array of mention suggestions used to populate the suggestion list\n   */\n  suggestions: Mention[];\n  /**\n   * Index of the currently focused suggestion, if any\n   */\n  activeSuggestionIndex?: number;\n  /**\n   * Optional string used as mention popover's title.\n   * @defaultValue `Suggestions`\n   */\n  title?: string;\n  /**\n   * Element to anchor the popover to.\n   */\n  target: React.RefObject<Element>;\n  /**\n   * When rendering the popover, where to position it relative to the target.\n   */\n  targetPositionOffset?: {\n    top: number;\n    left: number;\n  };\n  /**\n   * Where to display the suggestions relative to the target.\n   * @defaultValue `above`\n   */\n  location?: 'above' | 'below';\n  /**\n   * Callback called when a mention suggestion is selected.\n   */\n  onSuggestionSelected: (suggestion: Mention) => void;\n  /**\n   * Callback to invoke when the popover is dismissed\n   */\n  onDismiss?: () => void;\n  /**\n   * Optional callback to render an item of the mention suggestions list.\n   */\n  onRenderSuggestionItem?: (suggestion: Mention, onSuggestionSelected: (suggestion: Mention) => void, isActive: boolean) => JSX.Element;\n}\n\n/**\n * Options to lookup suggestions in the mention scenario.\n *\n * @beta\n */\nexport interface MentionLookupOptions {\n  /**\n   * Optional string to set trigger keyword for mention a specific participant.\n   *\n   * @defaultValue `@`\n   */\n  trigger?: string;\n  /**\n   * Optional callback to fetch a list of mention suggestions base on the query.\n   */\n  onQueryUpdated: (query: string) => Promise<Mention[]>;\n  /**\n   * Optional callback to render an item of the mention suggestions list.\n   */\n  onRenderSuggestionItem?: (suggestion: Mention, onSuggestionSelected: (suggestion: Mention) => void, isActive: boolean) => JSX.Element;\n}\n\n/**\n * Options to display suggestions in the mention scenario.\n *\n * @beta\n */\nexport interface MentionDisplayOptions {\n  /**\n   * Optional callback for customizing the mention renderer in a message thread.\n   */\n  onRenderMention?: (mention: Mention, defaultOnRender: (mention: Mention) => JSX.Element) => JSX.Element;\n}\n\n/**\n * Options to lookup suggestions and display mentions in the mention scenario.\n *\n * @beta\n */\nexport type MentionOptions = {\n  lookupOptions?: MentionLookupOptions;\n  displayOptions?: MentionDisplayOptions;\n};\n\n/**\n * Mention's state, as reflected in the UI.\n *\n * @beta\n */\nexport interface Mention {\n  /** ID of a mention */\n  id: string;\n  /** Display text of a mention */\n  displayText: string;\n  /** Optional React element to render an item icon of a mention suggestion */\n  icon?: JSX.Element;\n}\n\n/**\n * Strings of {@link _MentionPopover} that can be overridden.\n *\n * @beta\n */\nexport interface MentionPopoverStrings {\n  /**\n   * Header text for MentionPopover\n   */\n  mentionPopoverHeader: string;\n}\n\n/**\n * Component to render a pop-up of mention suggestions.\n *\n * @internal\n */\nexport const _MentionPopover = (props: _MentionPopoverProps): JSX.Element => {\n  interface Position {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n    maxWidth?: number;\n  }\n  const {\n    suggestions,\n    activeSuggestionIndex,\n    title,\n    target,\n    targetPositionOffset,\n    onRenderSuggestionItem,\n    onSuggestionSelected,\n    onDismiss,\n    location\n  } = props;\n  const theme = useTheme();\n  /* @conditional-compile-remove(mention) */\n  const ids = useIdentifiers();\n  const localeStrings = useLocale().strings;\n  const popoverRef = (useRef() as React.MutableRefObject<HTMLDivElement>);\n  const suggestionsListRef = useRef<HTMLDivElement>(null);\n  const [position, setPosition] = useState<Position | undefined>();\n  const [hoveredSuggestion, setHoveredSuggestion] = useState<Mention | undefined>(undefined);\n  const suggestionListStyle = useSuggestionListStyle();\n  const defaultStackStyles = useDefaultStackStyles();\n  const dismissPopoverWhenClickingOutside = useCallback((e: MouseEvent) => {\n    const target = (e.target as HTMLElement);\n    if (popoverRef.current && !popoverRef.current.contains(target)) {\n      onDismiss && onDismiss();\n    }\n  }, [onDismiss]);\n  useEffect(() => {\n    if (suggestionsListRef.current && activeSuggestionIndex !== undefined && activeSuggestionIndex >= 0) {\n      const selectedItem = suggestionsListRef.current.children[activeSuggestionIndex];\n      if (selectedItem) {\n        selectedItem.scrollIntoView({\n          behavior: 'smooth',\n          block: 'nearest'\n        });\n      }\n    }\n  }, [activeSuggestionIndex]);\n  useEffect(() => {\n    window && window.addEventListener('click', dismissPopoverWhenClickingOutside);\n    return () => {\n      window && window.removeEventListener('click', dismissPopoverWhenClickingOutside);\n    };\n  }, [dismissPopoverWhenClickingOutside]);\n\n  // Determine popover position\n  useEffect(() => {\n    const rect = target?.current?.getBoundingClientRect();\n    const maxWidth = 200;\n    const finalPosition: Position = {\n      maxWidth\n    };\n\n    // Figure out whether it will fit horizontally\n    const leftOffset = targetPositionOffset?.left ?? 0;\n    if (leftOffset + maxWidth > (rect?.width ?? 0)) {\n      finalPosition.right = (rect?.width ?? 0) - leftOffset;\n    } else {\n      finalPosition.left = leftOffset;\n    }\n    // Offset between cursor and mention popover\n    const verticalOffset = 4;\n    if (location === 'below') {\n      finalPosition.top = (rect?.height ?? 0) + (targetPositionOffset?.top ?? 0) + verticalOffset;\n    } else {\n      // (location === 'above')\n      finalPosition.bottom = (rect?.height ?? 0) - (targetPositionOffset?.top ?? 0) + verticalOffset;\n    }\n    setPosition(finalPosition);\n  }, [location, target, targetPositionOffset]);\n  const handleOnKeyDown = useCallback((e: React.KeyboardEvent<HTMLDivElement>) => {\n    switch (e.key) {\n      case 'Escape':\n        onDismiss && onDismiss();\n        break;\n      default:\n        break;\n    }\n  }, [onDismiss]);\n  const personaRenderer = useCallback((displayName: string): JSX.Element => {\n    const avatarOptions = {\n      text: displayName.trim(),\n      size: PersonaSize.size24,\n      initialsColor: theme.palette.neutralLight,\n      initialsTextColor: theme.palette.neutralSecondary,\n      showOverflowTooltip: false,\n      showUnknownPersonaCoin: false\n    };\n    return <Persona {...avatarOptions} />;\n  }, [theme]);\n  const defaultOnRenderSuggestionItem = useCallback((suggestion: Mention, onSuggestionSelected: (suggestion: Mention) => void, active: boolean): JSX.Element => {\n    return <div data-is-focusable={true}\n    /* @conditional-compile-remove(mention) */ data-ui-id={ids.mentionSuggestionItem} key={suggestion.id} onClick={() => onSuggestionSelected(suggestion)} onMouseEnter={() => setHoveredSuggestion(suggestion)} onMouseLeave={() => setHoveredSuggestion(undefined)} onKeyDown={e => {\n      handleOnKeyDown(e);\n    }} className={suggestionItemWrapperStyle(theme)}>\n          <Stack horizontal className={suggestionItemStackStyle(theme, hoveredSuggestion?.id === suggestion.id, active)}>\n            {personaRenderer(suggestion.displayText)}\n          </Stack>\n        </div>;\n  }, [handleOnKeyDown, theme, /* @conditional-compile-remove(mention) */\n  ids, hoveredSuggestion, personaRenderer]);\n  const getHeaderTitle = useCallback((): string => {\n    if (title) {\n      return title;\n    }\n    /* @conditional-compile-remove(mention) */\n    return localeStrings.mentionPopover.mentionPopoverHeader;\n    return '';\n  }, [localeStrings, title]);\n  return <div ref={popoverRef}>\n      {position && <Stack data-testid={'mention-suggestion-list-container'} className={mergeStyles({\n      maxHeight: 212,\n      maxWidth: position.maxWidth\n    }, mentionPopoverContainerStyle(theme), {\n      ...position,\n      position: 'absolute'\n    })}>\n          <Stack.Item styles={headerStyleThemed(theme)} aria-label={title}>\n            {getHeaderTitle()}\n          </Stack.Item>\n          {/* FluentUI v9 approach is used here instead of Stack because Stack doesn't have ref prop */}\n          <div className={mergeClasses(defaultStackStyles.root, suggestionListStyle.root)}\n      /* @conditional-compile-remove(mention) */ data-ui-id={ids.mentionSuggestionList} ref={suggestionsListRef}>\n            {suggestions.map((suggestion, index) => {\n          const active = index === activeSuggestionIndex;\n          return onRenderSuggestionItem ? onRenderSuggestionItem(suggestion, onSuggestionSelected, active) : defaultOnRenderSuggestionItem(suggestion, onSuggestionSelected, active);\n        })}\n          </div>\n        </Stack>}\n    </div>;\n};"]}

package/dist/dist-esm/react-components/src/components/SendBoxErrorBar.d.ts

@@ -1,34 +0,0 @@
-/// <reference types="react" />
-/**
- * @beta
- * Error to be displayed to the user in an error bar above sendbox.
- */
-export interface SendBoxErrorBarError {
-    /** Error Message to be displayed */
-    message: string;
-    /**
-     * Unix Timestamp. Preferred generation using `Date.now()`
-     */
-    timestamp: number;
-}
-/**
- * @private
- */
-export interface SendBoxErrorBarProps {
-    /** Error to render */
-    error?: SendBoxErrorBarError;
-    /**
-     * Automatically dismisses the error bar after the specified delay in ms.
-     * Example: `10 * 1000` would be 10 seconds
-     */
-    dismissAfterMs?: number;
-    /**
-     * Callback to invoke when the error bar is dismissed
-     */
-    onDismiss?: () => void;
-}
-/**
- * @private
- */
-export declare const SendBoxErrorBar: (props: SendBoxErrorBarProps) => JSX.Element;
-//# sourceMappingURL=SendBoxErrorBar.d.ts.map

package/dist/dist-esm/react-components/src/components/SendBoxErrorBar.js

@@ -1,42 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-import { MessageBar, MessageBarType } from '@fluentui/react';
-import React, { useEffect } from 'react';
-import { Announcer } from './Announcer';
-/**
- * @private
- */
-export const SendBoxErrorBar = (props) => {
-    const { error, dismissAfterMs, onDismiss } = props;
-    const [errorMessage, setErrorMessage] = React.useState(error === null || error === void 0 ? void 0 : error.message);
-    // Using `any` because `NodeJS.Timeout` here will cause `declaration error` with jest.
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const timeoutRef = React.useRef();
-    React.useEffect(() => {
-        setErrorMessage(error === null || error === void 0 ? void 0 : error.message);
-    }, [error]);
-    useEffect(() => {
-        if (error && dismissAfterMs !== undefined) {
-            timeoutRef.current = setTimeout(() => {
-                setErrorMessage(undefined);
-                onDismiss && onDismiss();
-            }, dismissAfterMs);
-        }
-        return () => {
-            timeoutRef.current && clearTimeout(timeoutRef.current);
-        };
-    }, [dismissAfterMs, onDismiss, error]);
-    if (errorMessage) {
-        return React.createElement(React.Fragment, null,
-            React.createElement(Announcer, { announcementString: errorMessage, ariaLive: 'polite' }),
-            React.createElement(MessageBar, { "data-testid": 'send-box-message-bar', messageBarType: MessageBarType.warning, styles: {
-                    iconContainer: {
-                        display: 'none'
-                    }
-                } }, errorMessage));
-    }
-    else {
-        return React.createElement(React.Fragment, null);
-    }
-};
-//# sourceMappingURL=SendBoxErrorBar.js.map

package/dist/dist-esm/react-components/src/components/SendBoxErrorBar.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SendBoxErrorBar.js","sourceRoot":"","sources":["../../../../../preprocess-dist/react-components/src/components/SendBoxErrorBar.tsx"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgCxC;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAe,EAAE;IAC1E,MAAM,EACJ,KAAK,EACL,cAAc,EACd,SAAS,EACV,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,CAAC,CAAC;IACvE,sFAAsF;IACtF,8DAA8D;IAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAO,CAAC;IACvC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,eAAe,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,CAAC,CAAC;IAClC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YAC1C,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACnC,eAAe,CAAC,SAAS,CAAC,CAAC;gBAC3B,SAAS,IAAI,SAAS,EAAE,CAAC;YAC3B,CAAC,EAAE,cAAc,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,IAAI,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACvC,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACH,oBAAC,SAAS,IAAC,kBAAkB,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAI;YACnE,oBAAC,UAAU,mBAAc,sBAAsB,EAAE,cAAc,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE;oBACjG,aAAa,EAAE;wBACb,OAAO,EAAE,MAAM;qBAChB;iBACF,IACI,YAAY,CACF,CACZ,CAAC;IACR,CAAC;SAAM,CAAC;QACN,OAAO,yCAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { MessageBar, MessageBarType } from '@fluentui/react';\nimport React, { useEffect } from 'react';\nimport { Announcer } from './Announcer';\n\n/**\n * @beta\n * Error to be displayed to the user in an error bar above sendbox.\n */\nexport interface SendBoxErrorBarError {\n  /** Error Message to be displayed */\n  message: string;\n  /**\n   * Unix Timestamp. Preferred generation using `Date.now()`\n   */\n  timestamp: number;\n}\n\n/**\n * @private\n */\nexport interface SendBoxErrorBarProps {\n  /** Error to render */\n  error?: SendBoxErrorBarError;\n  /**\n   * Automatically dismisses the error bar after the specified delay in ms.\n   * Example: `10 * 1000` would be 10 seconds\n   */\n  dismissAfterMs?: number;\n  /**\n   * Callback to invoke when the error bar is dismissed\n   */\n  onDismiss?: () => void;\n}\n\n/**\n * @private\n */\nexport const SendBoxErrorBar = (props: SendBoxErrorBarProps): JSX.Element => {\n  const {\n    error,\n    dismissAfterMs,\n    onDismiss\n  } = props;\n  const [errorMessage, setErrorMessage] = React.useState(error?.message);\n  // Using `any` because `NodeJS.Timeout` here will cause `declaration error` with jest.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const timeoutRef = React.useRef<any>();\n  React.useEffect(() => {\n    setErrorMessage(error?.message);\n  }, [error]);\n  useEffect(() => {\n    if (error && dismissAfterMs !== undefined) {\n      timeoutRef.current = setTimeout(() => {\n        setErrorMessage(undefined);\n        onDismiss && onDismiss();\n      }, dismissAfterMs);\n    }\n    return () => {\n      timeoutRef.current && clearTimeout(timeoutRef.current);\n    };\n  }, [dismissAfterMs, onDismiss, error]);\n  if (errorMessage) {\n    return <>\n        <Announcer announcementString={errorMessage} ariaLive={'polite'} />\n        <MessageBar data-testid={'send-box-message-bar'} messageBarType={MessageBarType.warning} styles={{\n        iconContainer: {\n          display: 'none'\n        }\n      }}>\n          {errorMessage}\n        </MessageBar>\n      </>;\n  } else {\n    return <></>;\n  }\n};"]}

package/dist/dist-esm/react-components/src/components/SendBoxErrors.d.ts

@@ -1,14 +0,0 @@
-/// <reference types="react" />
-import { SendBoxErrorBarError } from './SendBoxErrorBar';
-/**
- * @private
- */
-export interface SendBoxErrorsProps {
-    attachmentUploadsPendingError?: SendBoxErrorBarError;
-    attachmentUploadError?: SendBoxErrorBarError;
-}
-/**
- * @private
- */
-export declare const SendBoxErrors: (props: SendBoxErrorsProps) => JSX.Element;
-//# sourceMappingURL=SendBoxErrors.d.ts.map

package/dist/dist-esm/react-components/src/components/SendBoxErrors.js

@@ -1,18 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-import React from 'react';
-import { SendBoxErrorBar } from './SendBoxErrorBar';
-/**
- * @private
- */
-export const SendBoxErrors = (props) => {
-    const { attachmentUploadError, attachmentUploadsPendingError } = props;
-    const errorToDisplay = React.useMemo(() => {
-        if (attachmentUploadError && attachmentUploadsPendingError) {
-            return attachmentUploadError.timestamp > attachmentUploadsPendingError.timestamp ? attachmentUploadError : attachmentUploadsPendingError;
-        }
-        return attachmentUploadError || attachmentUploadsPendingError;
-    }, [attachmentUploadError, attachmentUploadsPendingError]);
-    return React.createElement(SendBoxErrorBar, { error: errorToDisplay, dismissAfterMs: 10 * 1000 });
-};
-//# sourceMappingURL=SendBoxErrors.js.map

package/dist/dist-esm/react-components/src/components/SendBoxErrors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SendBoxErrors.js","sourceRoot":"","sources":["../../../../../preprocess-dist/react-components/src/components/SendBoxErrors.tsx"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAwB,MAAM,mBAAmB,CAAC;AAU1E;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAe,EAAE;IACtE,MAAM,EACJ,qBAAqB,EACrB,6BAA6B,EAC9B,GAAG,KAAK,CAAC;IACV,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QACxC,IAAI,qBAAqB,IAAI,6BAA6B,EAAE,CAAC;YAC3D,OAAO,qBAAqB,CAAC,SAAS,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,6BAA6B,CAAC;QAC3I,CAAC;QACD,OAAO,qBAAqB,IAAI,6BAA6B,CAAC;IAChE,CAAC,EAAE,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC,CAAC;IAC3D,OAAO,oBAAC,eAAe,IAAC,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,EAAE,GAAG,IAAI,GAAI,CAAC;AAC/E,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport React from 'react';\nimport { SendBoxErrorBar, SendBoxErrorBarError } from './SendBoxErrorBar';\n\n/**\n * @private\n */\nexport interface SendBoxErrorsProps {\n  attachmentUploadsPendingError?: SendBoxErrorBarError;\n  attachmentUploadError?: SendBoxErrorBarError;\n}\n\n/**\n * @private\n */\nexport const SendBoxErrors = (props: SendBoxErrorsProps): JSX.Element => {\n  const {\n    attachmentUploadError,\n    attachmentUploadsPendingError\n  } = props;\n  const errorToDisplay = React.useMemo(() => {\n    if (attachmentUploadError && attachmentUploadsPendingError) {\n      return attachmentUploadError.timestamp > attachmentUploadsPendingError.timestamp ? attachmentUploadError : attachmentUploadsPendingError;\n    }\n    return attachmentUploadError || attachmentUploadsPendingError;\n  }, [attachmentUploadError, attachmentUploadsPendingError]);\n  return <SendBoxErrorBar error={errorToDisplay} dismissAfterMs={10 * 1000} />;\n};"]}

package/dist/dist-esm/react-components/src/components/TextFieldWithMention/TextFieldWithMention.d.ts

@@ -1,24 +0,0 @@
-import React, { FormEvent } from 'react';
-import { ITextField, ITextFieldProps } from '@fluentui/react';
-import { MentionLookupOptions } from '../MentionPopover';
-/**
- * Props for the TextFieldWithMention component.
- *
- * @private
- */
-export interface TextFieldWithMentionProps {
-    textFieldProps: ITextFieldProps;
-    dataUiId?: string;
-    textValue: string;
-    onChange: (event?: FormEvent<HTMLInputElement | HTMLTextAreaElement>, newValue?: string) => void;
-    onKeyDown?: (ev: React.KeyboardEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
-    onEnterKeyDown?: () => void;
-    textFieldRef?: React.RefObject<ITextField>;
-    supportNewline?: boolean;
-    mentionLookupOptions?: MentionLookupOptions;
-}
-/**
- * @private
- */
-export declare const TextFieldWithMention: (props: TextFieldWithMentionProps) => JSX.Element;
-//# sourceMappingURL=TextFieldWithMention.d.ts.map