@atlaskit/editor-common 71.0.3 → 72.0.1

package/dist/types/analytics/types/enums.d.ts

@@ -99,7 +99,7 @@ export declare enum ACTION {
     TYPING_FINISHED = "typingFinished",
     TYPING_STARTED = "typingStarted",
     UNLINK = "unlinked",
-    UNSUPPORTED_CONTENT_ENCOUNTERED = "unsupportedContentEncountered",
+    UNSUPPORTED_CONTENT_ENCOUNTERED = "unsupportedContentEncounteredV2",
     UPDATED = "updated",
     /** used in @atlassian/editor-referentiality */
     UPDATED_FRAGMENT_MARK_NAME = "updatedFragmentMarkName",
@@ -118,7 +118,17 @@ export declare enum ACTION {
     REMOVE_ICON = "removedIcon",
     UFO_SESSION_COMPLETE = "ufoSessionComplete",
     INVALID_PROSEMIRROR_DOCUMENT = "invalidProsemirrorDocument",
-    DOCUMENT_PROCESSING_ERROR = "documentProcessingError"
+    DOCUMENT_PROCESSING_ERROR = "documentProcessingError",
+    RENDERER_TTI = "tti",
+    CRASHED = "unhandledErrorCaught",
+    SELECT_ALL_CAUGHT = "selectAllCaught",
+    SELECT_ALL_ESCAPED = "selectAllEscaped",
+    SORT_COLUMN = "sortedColumn",
+    SORT_COLUMN_NOT_ALLOWED = "sortColumnNotAllowed",
+    CREATE_NOT_ALLOWED = "createNotAllowed",
+    UNSUPPORTED_CONTENT_LEVELS_TRACKING_SUCCEEDED = "unsupportedContentLevelsTrackingSucceeded",
+    UNSUPPORTED_CONTENT_LEVELS_TRACKING_ERRORED = "unsupportedContentLevelsTrackingErrored",
+    UNSUPPORTED_TOOLTIP_VIEWED = "viewed"
 }
 export declare enum INPUT_METHOD {
     ASCII = "ascii",
@@ -195,7 +205,11 @@ export declare enum ACTION_SUBJECT {
     SEARCH_RESULT = "searchResult",
     CREATE_LINK_INLINE_DIALOG = "createLinkInlineDialog",
     CODE_BLOCK = "codeBlock",
-    REACT_EDITOR_VIEW = "reactEditorView"
+    REACT_EDITOR_VIEW = "reactEditorView",
+    RENDERER = "renderer",
+    ANCHOR_LINK = "anchorLink",
+    LINK = "link",
+    TOOLTIP = "tooltip"
 }
 export declare enum ACTION_SUBJECT_ID {
     ACTION = "action",
@@ -310,9 +324,14 @@ export declare enum ACTION_SUBJECT_ID {
     TYPEAHEAD_QUICK_INSERT = "quickInsertTypeAhead",
     UNKNOWN_NODE = "unknownNode",
     UNLINK = "unlink",
+    HEADING_ANCHOR_LINK = "headingAnchorLink",
+    UNSUPPORTED_ERROR = "unsupportedUnhandled",
+    UNSUPPORTED_NODE_ATTRIBUTE = "unsupportedNodeAttribute",
     UNSUPPORTED_BLOCK = "unsupportedBlock",
     UNSUPPORTED_INLINE = "unsupportedInline",
-    UNSUPPORTED_MARK = "unsupportedMark"
+    UNSUPPORTED_MARK = "unsupportedMark",
+    ON_UNSUPPORTED_INLINE = "onUnsupportedInline",
+    ON_UNSUPPORTED_BLOCK = "onUnsupportedBlock"
 }
 export declare enum FLOATING_CONTROLS_TITLE {
     CODE_BLOCK = "codeBlockFloatingControls",

package/dist/types/collab/types.d.ts

@@ -20,7 +20,7 @@ export interface CollabEventInitData {
 export interface CollabEventRemoteData {
     json?: any;
     newState?: EditorState;
-    userIds?: string[];
+    userIds?: (number | string)[];
 }
 export interface CollabEventConnectionData {
     sid: string;

package/dist/types/i18n/index.d.ts

@@ -1,15 +1,16 @@
 /**
  * NOTE:
  *
- * This file is automatically generated by i18n-tools.
- * DO NOT CHANGE IT BY HAND or your changes will be lost.
+ * ED-16073:
+ * This was manually updated since the original `@atlaskit/i18n-tools` has been deprecated
  */
 export { default as zh } from './zh';
 export { default as zh_TW } from './zh_TW';
 export { default as cs } from './cs';
 export { default as da } from './da';
 export { default as nl } from './nl';
-export { default as et } from './et';
+export { default as en } from './en';
+export { default as en_GB } from './en_GB';
 export { default as fi } from './fi';
 export { default as fr } from './fr';
 export { default as de } from './de';

package/dist/types/i18n/languages.d.ts

@@ -0,0 +1,35 @@
+declare const _default: {
+    zh: string;
+    zh_TW: string;
+    cs: string;
+    da: string;
+    nl: string;
+    en: string;
+    en_GB: string;
+    fi: string;
+    fr: string;
+    de: string;
+    hu: string;
+    it: string;
+    ja: string;
+    ko: string;
+    nb: string;
+    pl: string;
+    pt_BR: string;
+    pt_PT: string;
+    ru: string;
+    sk: string;
+    es: string;
+    sv: string;
+    th: string;
+    tr: string;
+    uk: string;
+    vi: string;
+};
+/**
+ * NOTE:
+ *
+ * ED-16073:
+ * This was manually updated since the original `@atlaskit/i18n-tools` has been deprecated
+ */
+export default _default;

package/dist/types/keymaps/index.d.ts

@@ -73,6 +73,7 @@ export declare const ToolTipContent: React.MemoExoticComponent<({ description, s
 export declare function findKeymapByDescription(description: string): Keymap | undefined;
 export declare function findShortcutByDescription(description: string): string | undefined;
 export declare function findShortcutByKeymap(keymap: Keymap): string | undefined;
+export declare function getAriaKeyshortcuts(keymap: Keymap | string | undefined): string | undefined;
 export declare function makeKeymap(description: string, windows: string, mac: string, common?: string): Keymap;
 export declare function makeKeyMapWithCommon(description: string, common: string): Keymap;
 export interface Keymap {

package/dist/types/styles/index.d.ts

@@ -9,7 +9,7 @@ export { ruleSharedStyles } from './shared/rule';
 export { whitespaceSharedStyles } from './shared/whitespace';
 export { paragraphSharedStyles } from './shared/paragraph';
 export { linkSharedStyle } from './shared/link';
-export { listsSharedStyles, listPaddingLeftMarkerSpace } from './shared/lists';
+export { listsSharedStyles, listItemCounterPadding, getOrderedListInlineStyles, } from './shared/lists';
 export { indentationSharedStyles } from './shared/indentation';
 export { blockMarksSharedStyles } from './shared/block-marks';
 export { codeMarkSharedStyles } from './shared/code-mark';

package/dist/types/styles/shared/lists.d.ts

@@ -1,2 +1,4 @@
-export declare const listPaddingLeftMarkerSpace = 24;
+export declare const listItemCounterPadding = 24;
+export declare function getOrderedListInlineStyles(itemCounterDigitsSize: number, styleFormat: 'string'): string;
+export declare function getOrderedListInlineStyles(itemCounterDigitsSize: number, styleFormat: 'object'): Record<string, any>;
 export declare const listsSharedStyles: import("@emotion/react").SerializedStyles;

package/dist/types/types/collab.d.ts

@@ -2,7 +2,7 @@ export declare type NewCollabSyncUpErrorAttributes = {
     lengthOfUnconfirmedSteps?: number;
     tries: number;
     maxRetries: number;
-    clientId?: string;
+    clientId?: number | string;
     version: number;
 };
 export declare type SyncUpErrorFunction = (attributes: NewCollabSyncUpErrorAttributes) => void;

package/dist/types/types/copy-button.d.ts

@@ -9,6 +9,8 @@ export declare type MarkOptions = {
     markType: MarkType;
     onMouseEnter?: undefined;
     onMouseLeave?: undefined;
+    onFocus?: Command;
+    onBlur?: Command;
 };
 export declare type NodeOptions = {
     state: EditorState;
@@ -17,4 +19,6 @@ export declare type NodeOptions = {
     markType?: undefined;
     onMouseEnter?: Command;
     onMouseLeave?: Command;
+    onFocus?: Command;
+    onBlur?: Command;
 };

package/dist/types/types/feature-flags.d.ts

@@ -58,15 +58,6 @@ export declare type FeatureFlags = {
      * @default true
      */
     placeholderBracketHint?: boolean;
-    /**
-     * @description
-     * Whether placeholder hints were provided (`string[] => boolean`)
-     * Placeholder text values to display on new empty lines.
-     *
-     * @see https://product-fabric.atlassian.net/l/c/GG1Yv9cK
-     * @default false
-     */
-    placeholderHints?: boolean;
     /**
      * @description
      * Enable additional text colours within the colour palette.
@@ -99,15 +90,6 @@ export declare type FeatureFlags = {
      * @default false
      */
     extensionLocalIdGeneration?: boolean;
-    /**
-     * @description
-     * Enable date picker which has a textbox for internationalised keyboard date
-     * input.
-     *
-     * @see https://product-fabric.atlassian.net/browse/ED-8928
-     * @default false
-     */
-    keyboardAccessibleDatepicker?: boolean;
     /**
      * @description
      * Enable add column custom step
@@ -264,13 +246,6 @@ export declare type FeatureFlags = {
      * @default false
      */
     tableCellOptionsInFloatingToolbar?: boolean;
-    /**
-     * Number to distinguish between which different toolbar is being displayed
-     * as part of the smart link view changing experiment run by the Linking Platform.
-     * @see https://product-fabric.atlassian.net/browse/EDM-2640
-     * @default null
-     */
-    viewChangingExperimentToolbarStyle?: string;
     /**
      * @description
      * Enable display of a preview modal on mouse over of inline smart card
@@ -324,6 +299,16 @@ export declare type FeatureFlags = {
      * @default false
      */
     lpLinkPicker?: boolean;
+    /**
+     * @description
+     * Enables focus trap for the linking platform link picker
+     *
+     * @see https://product-fabric.atlassian.net/wiki/spaces/EM/pages/3158246501/PP+Link+Picker+-+Standalone
+     * @see https://product-fabric.atlassian.net/browse/EDM-2577
+     * @see https://product-fabric.atlassian.net/browse/EDM-4919
+     * @default false
+     */
+    lpLinkPickerFocusTrap?: boolean;
     /**
      * @description
      * Show link settings button in the Floating toolbar
@@ -360,6 +345,26 @@ export declare type FeatureFlags = {
      * @default false
      */
     restartNumberedListsToolbar?: boolean;
+    /**
+     * @description
+     * Show semantic text color names in tooltips when hovering over colors in the text color picker.
+     * Note that this flag is called 'somewhat semantic' as the text color names for white/dark gray
+     * colors are not semantic.
+     *
+     * @see https://product-fabric.atlassian.net/wiki/spaces/EUXQ/pages/3365994869/EXTERNAL+MAKE+PP+COMMIT-5058+Enable+dark+mode+usage+of+text+colors+in+UGC+and+non+custom+panels+in+Jira
+     * @see https://product-fabric.atlassian.net/browse/ED-16176
+     * @default false
+     */
+    useSomewhatSemanticTextColorNames?: boolean;
+    /**
+     * @description
+     * Force the Popup placement if the space does not accomodate the Popup fitHeight
+     *
+     * @see https://product-fabric.atlassian.net/wiki/spaces/EM/pages/3158246501/PP+Link+Picker+-+Standalone
+     * @see https://product-fabric.atlassian.net/browse/EDM-2577
+     * @default false
+     */
+    preventPopupOverflow?: boolean;
 };
 export declare type FeatureFlagKey = keyof FeatureFlags;
 export declare type GetEditorFeatureFlags = () => FeatureFlags;

package/dist/types/types/floating-toolbar.d.ts

@@ -20,6 +20,8 @@ export interface DropdownOptionT<T> {
     onMouseOver?: T;
     onMouseEnter?: T;
     onMouseLeave?: T;
+    onFocus?: T;
+    onBlur?: T;
     selected?: boolean;
     disabled?: boolean;
     hidden?: boolean;
@@ -52,12 +54,28 @@ interface Position {
     bottom?: number;
     left?: number;
 }
+export declare type ConfirmDialogChildInfo = {
+    id: string;
+    name: string;
+    amount: number;
+};
 export interface ConfirmDialogOptions {
     title?: string;
     message: string;
     okButtonLabel?: string;
     cancelButtonLabel?: string;
+    isReferentialityDialog?: boolean;
+    checkboxLabel?: string;
+    messagePrefix?: string;
+    getChildrenInfo?: () => ConfirmDialogChildInfo[];
+    onConfirm?: (...args: any[]) => Command;
 }
+export declare type ConfirmationDialogProps = {
+    onConfirm: (isCheck?: boolean) => void;
+    onClose: () => void;
+    options?: ConfirmDialogOptions;
+    testId?: string;
+};
 export declare type FloatingToolbarCopyButton = {
     type: 'copy-button';
     items: Array<FloatingToolbarSeparator | MarkOptions | NodeOptions>;
@@ -84,12 +102,13 @@ export declare type FloatingToolbarButton<T> = {
     tooltipContent?: React.ReactNode;
     testId?: string;
     hideTooltipOnClick?: boolean;
-    confirmDialog?: ConfirmDialogOptions;
+    confirmDialog?: ConfirmDialogOptions | (() => ConfirmDialogOptions);
     metadata?: {
         [key: string]: string;
     };
     ariaHasPopup?: boolean | 'dialog' | 'menu' | 'listbox' | 'tree' | 'grid' | undefined;
     tabIndex?: number | null | undefined;
+    focusEditoronEnter?: boolean;
 };
 export declare type FloatingToolbarInput<T> = {
     id: string;
@@ -153,6 +172,7 @@ export declare type FloatingToolbarSeparator = {
     hidden?: boolean;
 };
 export declare type FloatingToolbarDropdown<T> = {
+    testId?: string;
     id?: string;
     type: 'dropdown';
     title: string;
@@ -206,6 +226,11 @@ export interface FloatingToolbarConfig {
     forcePlacement?: boolean;
     onPositionCalculated?: (editorView: EditorView, nextPos: Position) => Position;
     scrollable?: boolean;
+    /**
+     * Enable Popup component's focus trap
+     */
+    focusTrap?: boolean;
+    preventPopupOverflow?: boolean;
 }
 export declare type FloatingToolbarHandler = (state: EditorState, intl: IntlShape, providerFactory: ProviderFactory) => FloatingToolbarConfig | undefined;
 export {};

package/dist/types/types/index.d.ts

@@ -18,7 +18,7 @@ export type { FeatureFlags, FeatureFlagKey, GetEditorFeatureFlags, } from './fea
 export type { Browsers, Range, DisableSpellcheckByBrowser, } from './supported-browsers';
 export type { EditorContainerWidth, GetEditorContainerWidth, } from './editor-container-width';
 export type { EmptyStateHandler, EmptyStateHandlerParams, } from './empty-state-handler';
-export type { RenderOptionsPropsT, DropdownOptionT, DropdownOptions, SelectOption, ButtonAppearance, Icon, RenderOptionsProps, AlignType, ConfirmDialogOptions, FloatingToolbarButton, FloatingToolbarCopyButton, FloatingToolbarInput, FloatingToolbarCustom, FloatingToolbarListPicker, FloatingToolbarColorPicker, FloatingToolbarEmojiPicker, FloatingToolbarDatePicker, FloatingToolbarSelect, FloatingToolbarSeparator, FloatingToolbarDropdown, FloatingToolbarFallbackItem, FloatingToolbarItem, FloatingToolbarConfig, FloatingToolbarHandler, } from './floating-toolbar';
+export type { RenderOptionsPropsT, DropdownOptionT, DropdownOptions, SelectOption, ButtonAppearance, Icon, RenderOptionsProps, AlignType, ConfirmDialogChildInfo, ConfirmDialogOptions, ConfirmationDialogProps, FloatingToolbarButton, FloatingToolbarCopyButton, FloatingToolbarInput, FloatingToolbarCustom, FloatingToolbarListPicker, FloatingToolbarColorPicker, FloatingToolbarEmojiPicker, FloatingToolbarDatePicker, FloatingToolbarSelect, FloatingToolbarSeparator, FloatingToolbarDropdown, FloatingToolbarFallbackItem, FloatingToolbarItem, FloatingToolbarConfig, FloatingToolbarHandler, } from './floating-toolbar';
 export type { MarkOptions, NodeOptions } from './copy-button';
 export type { ContextPanelHandler } from './context-panel';
 export type { EditorAppearance } from './editor-appearance';
@@ -29,6 +29,7 @@ export type { EditorReactContext } from './editor-react-context';
 export type { PMPluginFactoryParams, PMPluginFactory, PMPlugin, } from './plugin-factory';
 export type { NodeConfig, MarkConfig, NodeViewConfig, } from './prosemirror-config';
 export type { PluginsOptions, EditorPlugin, getPosHandler, getPosHandlerNode, } from './editor-plugin';
+export type { AllBuilderPlugins, VerifyPluginDependencies, AllNextEditorPlugins, NextEditorPlugin, NextEditorPluginWithDependencies, SafePresetCheck, } from './next-editor-plugin';
 export declare type IconProps = {
     label?: string;
 };

package/dist/types/types/next-editor-plugin.d.ts

@@ -0,0 +1,61 @@
+/**
+ * This entire file attempts to build out the type safety needed in our new
+ * plugin dependency injection approach, alongside our current implementation of
+ * `Presets` - if the generics get too unwieldy, we may redesign how presets
+ * are put together - but for now `Builder` & `Preset` aim to beinterchangeable.
+ */
+import type { EditorState } from 'prosemirror-state';
+import type { EditorPlugin } from './editor-plugin';
+interface DefaultEditorPlugin<Name extends string> extends EditorPlugin {
+    name: Name;
+}
+interface DefaultEditorPluginWithSharedPluginState<Name, PublicState> {
+    name: Name;
+    getSharedState: (editorState: EditorState) => PublicState;
+}
+declare type CheckSharedState<Name extends string, PublicState = never> = Exclude<PublicState, never> extends never ? DefaultEditorPlugin<Name> : DefaultEditorPluginWithSharedPluginState<Name, PublicState>;
+export declare type NextEditorPlugin<Name extends string, PublicState = never, PluginConfiguration extends unknown | undefined = unknown> = any extends Function ? Exclude<unknown, PluginConfiguration> extends never ? (optionalConfig?: PluginConfiguration) => CheckSharedState<Name, PublicState> : Exclude<PluginConfiguration, Exclude<PluginConfiguration, undefined>> extends never ? (mandatoryConfig: PluginConfiguration) => CheckSharedState<Name, PublicState> : (optionalKnownConfig?: PluginConfiguration) => CheckSharedState<Name, PublicState> : never;
+declare type getNextEditorPluginStateType<T> = T extends NextEditorPlugin<any, infer U, any> ? U : never;
+declare type getNextEditorPluginNameType<T> = T extends NextEditorPlugin<infer U, any, any> ? U : never;
+declare type ExternalPluginAPIProps<T extends NextEditorPlugin<any, any, any>> = {
+    sharedPluginState: {
+        currentState: () => getNextEditorPluginStateType<T>;
+        onChange: (sub: (props: getNextEditorPluginStateType<T>) => void) => void;
+    };
+};
+declare type ExternalPluginAPI<PluginList extends AllBuilderPlugins[]> = {
+    [Plugin in PluginList[number] extends NextEditorPluginWithDependencies<any, any, any, any> ? ReturnType<PluginList[number]> : PluginList[number] as getNextEditorPluginNameType<Plugin>]: Plugin extends NextEditorPlugin<any, any, any> ? ExternalPluginAPIProps<Plugin> : never;
+};
+export declare type NextEditorPluginWithDependencies<NextEditorPluginKey extends string, NextEditorPluginPublicState, D extends AllBuilderPlugins[], NextEditorPluginConfiguration extends unknown | undefined = unknown> = (props: {
+    externalPlugins: ExternalPluginAPI<D>;
+}) => NextEditorPlugin<NextEditorPluginKey, NextEditorPluginPublicState, NextEditorPluginConfiguration>;
+export declare type PluginAsArray<A extends string, B = never, C = unknown> = C extends C & undefined ? [NextEditorPlugin<A, B, C>, C?] : [NextEditorPlugin<A, B, C>, C];
+export declare type PluginWithDependenciesAsArray<A extends string, B, C extends AllBuilderPlugins[], D extends unknown = unknown> = D extends D & undefined ? [NextEditorPluginWithDependencies<A, B, C, D>, D?] : [NextEditorPluginWithDependencies<A, B, C, D>, D];
+declare type AllPluginsAsArray = PluginAsArray<string, any, any> | PluginWithDependenciesAsArray<string, any, any, any>;
+export declare type AllNextEditorPlugins = NextEditorPlugin<string, any, any> | NextEditorPluginWithDependencies<string, any, any, any>;
+export declare type AllBuilderPlugins = AllPluginsAsArray | AllNextEditorPlugins;
+declare type ExtractNextEditorPlugin<T> = T extends PluginAsArray<string, any, any> | PluginWithDependenciesAsArray<string, any, any, any> ? T[0] : never;
+export declare type VerifyPluginDependencies<T, Plugins extends AllBuilderPlugins[]> = T extends NextEditorPluginWithDependencies<string, any, infer D, any> | PluginWithDependenciesAsArray<string, any, infer D, any> ? 
+/**
+ * case 1: We're looking for its dependent plugins indexed on `AllBuilderPlugins`
+ */
+D[number] extends (D[number] & Plugins[number])
+/**
+ * case 2:
+ * Otherwise check whether the dependent-plugin, is hidden inside a tuple,
+ * unwrapping `Plugins` via `ExtractNextEditorPlugin`
+ */
+ | (D[number] & ExtractNextEditorPlugin<Plugins[number]>) ? T : never : T extends PluginAsArray<any, any, any> | NextEditorPlugin<any, any, any> ? T : never;
+/**
+ * Used to check if a plugin being added can be added to a Preset/builder
+ */
+export declare type SafePresetCheck<Plugin, StackPlugins extends AllBuilderPlugins[]> = Plugin extends Plugin & VerifyPluginDependencies<Plugin, StackPlugins> ? Plugin extends NextEditorPluginWithDependencies<string, any, any, infer Config> ? CheckPluginWithDependency<Plugin, Config, StackPlugins> : Plugin extends NextEditorPlugin<any, any, infer Config> ? CheckBasicPlugin<Plugin, Config> : never : Plugin extends (config: infer Config) => EditorPlugin ? 
+/** Checks whether config has any mandatory fields - if so, config cannot be optional */
+Exclude<unknown, Config> extends never ? Plugin | [Plugin] : Exclude<unknown, Config> extends never ? Plugin | [Plugin] | [Plugin, Config] : [
+    Plugin,
+    Config
+] : never;
+declare type CheckTupleRequirements<Plugin, Config, ArrayType> = Plugin extends Plugin ? Exclude<unknown, Config> extends never ? Plugin | ArrayType : Exclude<Config, Exclude<Config, undefined>> extends never ? Plugin | ArrayType : ArrayType : never;
+declare type CheckPluginWithDependency<Plugin, Config, StackPlugins extends AllBuilderPlugins[]> = Plugin extends (...args: any) => (...args: any) => EditorPlugin ? CheckTupleRequirements<Plugin, Config, PluginWithDependenciesAsArray<any, any, StackPlugins, Config | undefined>> : never;
+declare type CheckBasicPlugin<Plugin, Config> = Plugin extends (...args: any) => EditorPlugin ? CheckTupleRequirements<Plugin, Config, PluginAsArray<any, any, Config | undefined>> : never;
+export {};

package/dist/types/ui/Emoji/index.d.ts

@@ -1,4 +1,5 @@
 import { PureComponent } from 'react';
+import { EmojiResourceConfig } from '@atlaskit/emoji/resource';
 import { EmojiId } from '@atlaskit/emoji/types';
 import { ProviderFactory } from '../../provider-factory';
 export interface EmojiProps extends EmojiId {
@@ -6,6 +7,7 @@ export interface EmojiProps extends EmojiId {
     providers?: ProviderFactory;
     fitToHeight?: number;
     showTooltip?: boolean;
+    resourceConfig?: EmojiResourceConfig;
 }
 export default class EmojiNode extends PureComponent<EmojiProps, {}> {
     static displayName: string;

package/dist/types/ui/Popup/index.d.ts

@@ -20,6 +20,9 @@ export interface Props {
     allowOutOfBounds?: boolean;
     rect?: DOMRect;
     style?: React.CSSProperties;
+    /** Enable focus trap to contain the user's focus within the popup */
+    focusTrap?: boolean;
+    preventOverflow?: boolean;
 }
 export interface State {
     popup?: HTMLElement;
@@ -35,6 +38,8 @@ export default class Popup extends React.Component<Props, State> {
         allowOutOfBound: boolean;
     };
     state: State;
+    private popupRef;
+    private focusTrap?;
     private placement;
     /**
      * Calculates new popup position
@@ -52,6 +57,20 @@ export default class Popup extends React.Component<Props, State> {
     onResize: () => void;
     UNSAFE_componentWillReceiveProps(newProps: Props): void;
     resizeObserver: ResizeObserver | undefined;
+    /**
+     * Raf scheduled so that it also occurs after the initial update position
+     */
+    private initFocusTrap;
+    /**
+     * Cancels the initialisation of the focus trap if it has not yet occured
+     * Deactivates the focus trap if it exists
+     */
+    private destroyFocusTrap;
+    /**
+     * Handle pausing, unpausing, and initialising (if not yet initialised) of the focus trap
+     */
+    handleChangedFocusTrapProp(prevProps: Props): void;
+    componentDidUpdate(prevProps: Props): void;
     componentDidMount(): void;
     componentWillUnmount(): void;
     private renderPopup;

package/dist/types/ui/Popup/utils.d.ts

@@ -18,12 +18,12 @@ export declare function isTextNode(elem: HTMLElement | Element): boolean;
 /**
  * Decides if given fitHeight fits below or above the target taking boundaries into account.
  */
-export declare function getVerticalPlacement(target: HTMLElement, boundariesElement: HTMLElement, fitHeight?: number, alignY?: string, forcePlacement?: boolean): string;
+export declare function getVerticalPlacement(target: HTMLElement, boundariesElement: HTMLElement, fitHeight?: number, alignY?: string, forcePlacement?: boolean, preventOverflow?: boolean): string;
 /**
  * Decides if given fitWidth fits to the left or to the right of the target taking boundaries into account.
  */
-export declare function getHorizontalPlacement(target: HTMLElement, boundariesElement: HTMLElement, fitWidth?: number, alignX?: string, forcePlacement?: boolean): string;
-export declare function calculatePlacement(target: HTMLElement, boundariesElement: HTMLElement, fitWidth?: number, fitHeight?: number, alignX?: string, alignY?: string, forcePlacement?: boolean): [string, string];
+export declare function getHorizontalPlacement(target: HTMLElement, boundariesElement: HTMLElement, fitWidth?: number, alignX?: string, forcePlacement?: boolean, preventOverflow?: boolean): string;
+export declare function calculatePlacement(target: HTMLElement, boundariesElement: HTMLElement, fitWidth?: number, fitHeight?: number, alignX?: string, alignY?: string, forcePlacement?: boolean, preventOverflow?: boolean): [string, string];
 /**
  * Calculates relative coordinates for placing popup along with the target.
  * Uses placement from calculatePlacement.