@ynput/ayon-frontend-shared 0.6.8 → 0.7.0

package/dist/types/components.d.ts

@@ -12,11 +12,17 @@ import { Component } from 'react';
 import { Context } from 'react';
 import { coreModuleName } from '@reduxjs/toolkit/query';
 import { CSSProperties } from 'react';
+import { DecoratorBlockNode } from '@lexical/react/LexicalDecoratorBlockNode';
 import { default as default_2 } from 'react';
 import { DetailedHTMLProps } from 'react';
 import { DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES } from 'react';
 import { DocumentNode } from 'graphql';
+import { DOMConversionMap } from 'lexical';
+import { DOMExportOutput } from 'lexical';
 import { DropdownRef } from '@ynput/ayon-react-components';
+import { EditorConfig } from 'lexical';
+import { ElementFormatType } from 'lexical';
+import { ElementNode } from 'lexical';
 import { ExecutionProps } from 'styled-components';
 import { FastOmit } from 'styled-components';
 import { FC } from 'react';
@@ -33,11 +39,16 @@ import { ImgHTMLAttributes } from 'react';
 import { InputHTMLAttributes } from 'react';
 import { IStyledComponentBase } from 'styled-components/dist/types';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { JSX as JSX_3 } from 'react';
 import { LabelHTMLAttributes } from 'react';
+import { LexicalCommand } from 'lexical';
+import { LexicalEditor } from 'lexical';
+import { LexicalNode } from 'lexical';
 import { MouseEvent as MouseEvent_2 } from 'react';
 import { MutationActionCreatorResult } from '@reduxjs/toolkit/query';
 import { MutationDefinition } from '@reduxjs/toolkit/query';
 import { NamedExoticComponent } from 'react';
+import { NodeKey } from 'lexical';
 import { Option as Option_2 } from '@ynput/ayon-react-components';
 import { OverrideResultType } from '@reduxjs/toolkit/query';
 import { QueryDefinition } from '@reduxjs/toolkit/query';
@@ -48,9 +59,15 @@ import { RefAttributes } from 'react';
 import { RefObject } from 'react';
 import { SearchFilterGroupOption } from '@ynput/ayon-react-components';
 import { SearchFilterRef } from '@ynput/ayon-react-components';
+import { SerializedDecoratorBlockNode } from '@lexical/react/LexicalDecoratorBlockNode';
 import { SerializedError } from '@reduxjs/toolkit';
+import { SerializedTextNode } from 'lexical';
 import { SortingState } from '@tanstack/react-table';
+import { Spread } from 'lexical';
+import { TextMatchTransformer } from '@lexical/markdown';
+import { TextNode } from 'lexical';
 import { ThunkDispatch } from '@reduxjs/toolkit';
+import { Transformer as Transformer_2 } from '@lexical/markdown';
 import { TSHelpersNoInfer } from '@reduxjs/toolkit/query';
 import { UnknownAction } from '@reduxjs/toolkit';
 import { UpdateDefinitions } from '@reduxjs/toolkit/query';
@@ -62,6 +79,22 @@ import { VisibilityState } from '@tanstack/react-table';
 import { WatcherSelectProps } from '@ynput/ayon-react-components';
 import { WebTarget } from 'styled-components';
 
+export declare const $createMediaNode: (payload: MediaPayload) => MediaNode;
+
+export declare const $createMentionNode: (type: string, id: string, label: string) => MentionNode;
+
+export declare const $createYouTubeNode: (url: string) => YouTubeNode;
+
+export declare const $getMarkdown: (node?: ElementNode) => string;
+
+export declare const $isMediaNode: (node: LexicalNode | null | undefined) => node is MediaNode;
+
+export declare const $isMentionNode: (node: LexicalNode | null | undefined) => node is MentionNode;
+
+export declare const $isYouTubeNode: (node: LexicalNode | null | undefined) => node is YouTubeNode;
+
+export declare const $setMarkdown: (markdown: string) => void;
+
 export declare const ACCESS_LEVEL_LABELS: {
     0: string;
     10: string;
@@ -114,6 +147,8 @@ declare interface Action extends ButtonProps {
 
 declare const ActionWrapper: IStyledComponentBase<"web", FastOmit<DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never> & Partial<Pick< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>>> & string;
 
+export declare const ACTIVITY_LINK_LABEL = "Comment";
+
 export declare const AddColumnButton: FC<AddColumnButtonProps>;
 
 declare interface AddColumnButtonProps {
@@ -285,6 +320,10 @@ declare type BaseProps = React.HTMLAttributes<HTMLDivElement> & {
 
 export declare const BLOCK_DIALOG_CLOSE_CLASS = "block-dialog-close";
 
+export declare type BlockFormat = Exclude<BlockType, 'paragraph' | 'heading'>;
+
+declare type BlockType = 'paragraph' | 'h1' | 'h2' | 'h3' | 'heading' | 'quote' | 'code' | 'bullet' | 'number' | 'check';
+
 declare type BooleanCalc = 'checked' | 'notChecked';
 
 export declare const buildChildrenDetails: (topLevelFolders: DeletableEntity[], folderInfo: FolderDeleteInfo[]) => string[];
@@ -313,6 +352,8 @@ export declare type BuildFilterOptions = {
 
 export declare const buildScopes: (scopes: ScopeType_2[], exclude?: Partial<Record<ScopeType_2, FilterFieldType[]>>) => ScopeWithFilterTypes[];
 
+export declare const buildSortMenuItem: <T extends string>({ options, sort, onChange, id, label, icon, }: SortMenuItemArgs<T>) => MenuItemType;
+
 declare type BundleMode = 'production' | 'staging' | 'developer';
 
 declare const Button: IStyledComponentBase<"web", FastOmit<Omit< ButtonProps & RefAttributes<HTMLButtonElement>, "ref"> & {
@@ -328,6 +369,7 @@ export declare const Chips: FC<ChipsProps>;
 declare interface ChipsProps {
     values: ChipValue[];
     disabled?: boolean;
+    className?: string;
     pt?: {
         chip?: Partial<HTMLAttributes<HTMLDivElement>>;
     };
@@ -339,6 +381,7 @@ export declare type ChipValue = {
     icon?: string;
     prefix?: default_2.ReactNode;
     suffix?: default_2.ReactNode;
+    onClick?: default_2.MouseEventHandler<HTMLDivElement>;
 };
 
 declare type ColorInputPt = Partial<React.InputHTMLAttributes<HTMLInputElement>>;
@@ -503,6 +546,12 @@ declare interface ContextMenuItemType extends Omit<ContextMenuItemProps, 'contex
     [key: string]: any;
 }
 
+/**
+ * Mention source backed by the activity feed's mention suggestions (`useGetEntityMentionsQuery`),
+ * using the same option builders and sorting as the legacy comment input.
+ */
+export declare const createFeedMentionSource: ({ suggestions, project, taskTypes, entityType, }: FeedMentionSourceOptions) => MentionSource;
+
 declare type CreateViewApiArg = {
     viewType: string;
     projectName?: string;
@@ -608,6 +657,8 @@ export declare interface DateRangePickerProps {
 
 export declare const DEFAULT_FEATURED_ORDER: string[];
 
+export declare const DEFAULT_TOOLBAR: ToolbarLayout;
+
 declare type DefaultProductBaseType_2 = {
     color?: string;
     icon?: string;
@@ -669,6 +720,8 @@ declare type DeliveryTemplate = {
     file: string;
 };
 
+export declare const DESCRIPTION_TOOLBAR: ToolbarLayout;
+
 declare interface DescriptionMentionsContext {
     projectName: string;
     entityType: string;
@@ -701,7 +754,7 @@ declare interface DescriptionSectionProps {
     }, target: HTMLElement) => void;
 }
 
-export declare const DetailsDialog: ({ projectName, entityType, entityIds, visible, onHide, }: DetailsDialogProps) => JSX_2.Element | null;
+export declare const DetailsDialog: ({ projectName, entityType, entityIds, visible, onHide, data: dataProp, header, }: DetailsDialogProps) => JSX_2.Element | null;
 
 export declare interface DetailsDialogProps {
     projectName?: string;
@@ -709,6 +762,8 @@ export declare interface DetailsDialogProps {
     entityIds: string[];
     visible: boolean;
     onHide: () => void;
+    data?: unknown;
+    header?: string;
 }
 
 declare type DetailsField = Pick<AttributeField, 'name' | 'data' | 'hidden'>;
@@ -947,6 +1002,15 @@ declare interface EarlyPreviewProps extends React.HTMLAttributes<HTMLDivElement>
 
 declare type EditingViewState = string | true | null;
 
+export declare interface EditorCommand {
+    id: string;
+    label: string;
+    icon: string;
+    keywords?: string[];
+    hint?: string;
+    run: () => void;
+}
+
 export declare const EmptyPlaceholder: FC<EmptyPlaceholderProps>;
 
 export declare const EmptyPlaceholderFlex: IStyledComponentBase<"web", FastOmit<EmptyPlaceholderProps, never> & Partial<Pick< EmptyPlaceholderProps, never>>> & string & Omit< FC<EmptyPlaceholderProps>, keyof Component<any, {}, any>>;
@@ -1245,6 +1309,13 @@ declare type FeedFrameLinkPreview = {
     link: CommentFrameLink | null;
 };
 
+declare interface FeedMentionSourceOptions {
+    suggestions?: SuggestResponse;
+    project?: Pick<ProjectContextValue, 'productTypes'>;
+    taskTypes?: TaskType_3[];
+    entityType?: string;
+}
+
 export declare const FieldLabel: default_2.FC<FieldLabelProps>;
 
 declare interface FieldLabelProps extends default_2.HTMLAttributes<HTMLDivElement> {
@@ -1332,7 +1403,9 @@ export declare interface FilterErrorActionsProps {
     errorMessage?: string;
 }
 
-export declare type FilterFieldType = 'folderType' | 'taskType' | 'productType' | 'productBaseType' | ('users' | 'assignees' | 'author') | 'attributes' | 'status' | 'tags' | 'version' | 'hasReviewables' | 'productName' | 'name' | 'createdAt' | 'updatedAt';
+export declare type FilterFieldType = 'folderType' | 'taskType' | 'productType' | 'productBaseType' | ('users' | 'assignees' | 'author') | 'attributes' | 'status' | 'tags' | 'version' | 'hasReviewables' | 'productName' | 'name' | 'extension' | 'createdAt' | 'updatedAt';
+
+export declare const FLOATING_TOOLBAR: ToolbarLayout;
 
 declare type FolderDeleteInfo = {
     id: string;
@@ -1360,6 +1433,18 @@ declare interface FolderProduct {
     } | null;
 }
 
+declare type FolderSuggestionItem = {
+    /** The date and time when the suggested entity was created */
+    createdAt?: string;
+    /** The relevance score of the suggestion */
+    relevance?: number;
+    id: string;
+    folderType: string;
+    name: string;
+    label?: string;
+    thumbnailId?: string;
+};
+
 declare type FolderType = {
     name: string;
     original_name?: string;
@@ -1552,6 +1637,39 @@ export declare const getGroupedReviewables: (reviewables: ReviewableResponse[],
     queued: ReviewableResponse[];
 };
 
+/**
+ * Ids of the project files shown as image / video blocks in the markdown. Only standalone media
+ * images count, not file urls in prose, links or code blocks.
+ */
+export declare const getInlineMediaFileIds: (markdown?: string | null) => Set<string>;
+
+/**
+ * A short label for a link to a well known site, made only from the url (nothing is fetched),
+ * e.g. `https://github.com/ynput/ayon-frontend/issues/2342` → `ayon-frontend #2342`.
+ * Returns null for urls without a known structure, which keep the url as their text.
+ */
+export declare const getLinkLabel: (href: string) => string | null;
+
+/**
+ * Image or video, from the mime type (written as the markdown image title by the editor) or else
+ * the file extension of the url / name. Defaults to image, markdown images are images.
+ */
+export declare const getMediaKind: (mime?: string | null, ...names: (string | null | undefined)[]) => "video" | "image";
+
+export declare const getMentionTrigger: (type: string) => MentionTrigger;
+
+export declare const getProjectFileId: (src?: string | null) => string | null;
+
+/**
+ * The link a duplicated comment keeps to the comment it was copied from:
+ * `source:{activityId}?type={entityType}&id={entityId}`. The entity is the one the source comment
+ * belongs to, which can differ from the entity the copy is posted on.
+ */
+export declare const getSourceLink: (activityId: string, entity?: {
+    id: string;
+    type: string;
+}) => string;
+
 export declare const getUiTypeLabel: (type: AttributeData_2["type"] | undefined, enumValues?: AttributeData_2["enum"], enumResolver?: AttributeData_2["enumResolver"]) => string;
 
 declare type GetViewApiArg = {
@@ -1599,6 +1717,28 @@ export declare const groupLinksByEntity: (links: LinkEntity[]) => GroupedLink[];
 
 export declare const GUEST_KEY_PREFIX = "guest:";
 
+declare interface HastNode {
+    type: string;
+    tagName?: string;
+    value?: string;
+    properties?: {
+        href?: string;
+    };
+    children?: HastNode[];
+}
+
+declare interface HastNode_2 {
+    type: string;
+    tagName?: string;
+    value?: string;
+    properties?: {
+        src?: string;
+        alt?: string;
+        title?: string;
+    };
+    children?: HastNode_2[];
+}
+
 export declare interface HeightSliderProps {
     value: number;
     onChange: (value: number) => void;
@@ -1668,6 +1808,10 @@ declare const InputText: IStyledComponentBase<"web", FastOmit<Omit< InputHTMLAtt
     ref?: ((instance: HTMLInputElement | null) => void | DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | RefObject<HTMLInputElement> | null | undefined;
 }, never>>> & string & Omit< ForwardRefExoticComponent< InputHTMLAttributes<HTMLInputElement> & RefAttributes<HTMLInputElement>>, keyof Component<any, {}, any>>;
 
+export declare const INSERT_MENTION_TRIGGER_COMMAND: LexicalCommand<MentionTrigger>;
+
+export declare const isMediaFile: (file: File) => boolean;
+
 export declare const JsonViewer: FC<JsonViewerProps>;
 
 export declare interface JsonViewerProps {
@@ -1838,8 +1982,204 @@ declare type ListViewsApiArg = {
 
 declare type MainCalc = 'count' | 'breakdown';
 
+export declare const MARKDOWN_TRANSFORMERS: Transformer_2[];
+
+/**
+ * Rich text editor that reads and writes markdown.
+ * Supports text formats, links, lists, check lists, quotes, inline code and code blocks and
+ * mentions (`@user`, `@@version`, `@@@task`) stored as `[label](type:id)`.
+ */
+export declare const MarkdownEditor: ForwardRefExoticComponent<MarkdownEditorProps & RefAttributes<MarkdownEditorHandle>>;
+
+export declare interface MarkdownEditorHandle {
+    getEditor: () => LexicalEditor;
+    focus: () => void;
+    blur: () => void;
+    getMarkdown: () => string;
+    setMarkdown: (markdown: string) => void;
+    clear: () => void;
+    isEmpty: () => boolean;
+    insertMentionTrigger: (trigger: MentionTrigger) => void;
+}
+
+export declare interface MarkdownEditorProps extends MentionEventHandlers {
+    variant?: MarkdownEditorVariant;
+    value?: string;
+    onChange?: (markdown: string) => void;
+    placeholder?: string;
+    onSubmit?: () => void;
+    submitOnEnter?: boolean;
+    onEscape?: () => void;
+    onFiles?: (files: File[]) => void;
+    onUploadMedia?: UploadMedia;
+    mentions?: MentionSource;
+    mentionMenuParent?: HTMLElement;
+    mentionPlacement?: MentionPlacement;
+    emoji?: boolean;
+    slashCommands?: boolean;
+    commands?: EditorCommand[];
+    toolbar?: boolean | ToolbarLayout;
+    floatingToolbar?: boolean | ToolbarLayout;
+    toolbarStart?: ReactNode;
+    toolbarEnd?: ReactNode;
+    footer?: ReactNode;
+    actions?: ReactNode;
+    autoFocus?: boolean;
+    readOnly?: boolean;
+    bordered?: boolean;
+    minHeight?: number;
+    maxHeight?: number;
+    namespace?: string;
+    className?: string;
+    style?: CSSProperties;
+    contentClassName?: string;
+    children?: ReactNode;
+}
+
+export declare type MarkdownEditorVariant = 'document' | 'message';
+
+/**
+ * Markdown as one line of plain text, e.g. for a summary of a description change. Mentions and
+ * links become their label, images their name, and formatting, block markers and line breaks go.
+ */
+export declare const markdownToPlainText: (markdown: string) => string;
+
 declare type Maybe<T> = T | null;
 
+export declare const MediaBlock: ({ src, alt, mime, uploading, onOpen, className }: MediaBlockProps) => JSX_2.Element;
+
+declare interface MediaBlockProps {
+    src: string;
+    alt?: string;
+    mime?: string | null;
+    uploading?: boolean;
+    onOpen?: () => void;
+    className?: string;
+}
+
+/**
+ * An image or video block. Stored in markdown as an image on its own line with the mime type as
+ * its title: `![clip.mp4](/api/projects/p/files/id "video/mp4")`.
+ */
+export declare class MediaNode extends DecoratorBlockNode {
+    __src: string;
+    __alt: string;
+    __mime: string | null;
+    __uploading: boolean;
+    static getType(): string;
+    static clone(node: MediaNode): MediaNode;
+    static importJSON(serializedNode: SerializedMediaNode): MediaNode;
+    constructor(payload: MediaPayload, format?: ElementFormatType, key?: NodeKey);
+    exportJSON(): SerializedMediaNode;
+    exportDOM(): DOMExportOutput;
+    static importDOM(): DOMConversionMap | null;
+    updateDOM(): false;
+    getSrc(): string;
+    getAlt(): string;
+    getMime(): string | null;
+    isUploading(): boolean;
+    setUploaded(src: string, { alt, mime }?: {
+        alt?: string;
+        mime?: string | null;
+    }): this;
+    getTextContent(): string;
+    decorate(_editor: LexicalEditor, config: EditorConfig): JSX_3.Element;
+}
+
+declare interface MediaPayload {
+    src: string;
+    alt?: string;
+    mime?: string | null;
+    uploading?: boolean;
+}
+
+export declare const MENTION: TextMatchTransformer;
+
+export declare const MENTION_REF_TYPES: readonly ["user", "team", "task", "version", "folder", "representation", "workfile", "product"];
+
+export declare const MENTION_TRIGGER_BY_TYPE: Record<string, MentionTrigger>;
+
+export declare interface MentionEventHandlers {
+    onMentionClick?: (mention: {
+        type: string;
+        id: string;
+        label: string;
+    }, e: MouseEvent) => void;
+    onMentionHover?: (mention: {
+        type: string;
+        id: string;
+        label: string;
+    }, target: HTMLElement) => void;
+}
+
+export declare interface MentionFilter {
+    id: string;
+    icon: string;
+    tooltip: string;
+}
+
+export declare interface MentionItem {
+    type: string;
+    id: string;
+    label: string;
+    icon?: string;
+    color?: string;
+    context?: string;
+    suffix?: string;
+}
+
+/**
+ * An inline reference to a user, team, task, version... rendered as `@label` and stored in
+ * markdown as `[label](type:id)`. It is a token so it can only be selected and deleted as a whole.
+ */
+export declare class MentionNode extends TextNode {
+    __mentionType: string;
+    __mentionId: string;
+    static getType(): string;
+    static clone(node: MentionNode): MentionNode;
+    static importJSON(serializedNode: SerializedMentionNode): MentionNode;
+    constructor(mentionType: string, mentionId: string, text: string, key?: NodeKey);
+    exportJSON(): SerializedMentionNode;
+    getMentionType(): string;
+    getMentionId(): string;
+    getLabel(): string;
+    getMentionValue(): string;
+    createDOM(config: EditorConfig): HTMLElement;
+    exportDOM(): DOMExportOutput;
+    static importDOM(): DOMConversionMap | null;
+    isTextEntity(): true;
+    canInsertTextBefore(): boolean;
+    canInsertTextAfter(): boolean;
+}
+
+export declare type MentionPlacement = 'inline' | 'top';
+
+export declare interface MentionQuery {
+    trigger: MentionTrigger;
+    search: string;
+    filter: string | null;
+}
+
+export declare type MentionRefType = (typeof MENTION_REF_TYPES)[number];
+
+export declare interface MentionSource {
+    triggers?: MentionTrigger[];
+    config?: Partial<Record<MentionTrigger, Partial<MentionTriggerConfig>>>;
+    getOptions: (query: MentionQuery) => MentionItem[];
+    getError?: (trigger: MentionTrigger) => string | null | undefined;
+    limit?: number;
+    renderOptionImage?: (option: MentionItem) => ReactNode;
+}
+
+export declare type MentionTrigger = '@' | '@@' | '@@@';
+
+export declare interface MentionTriggerConfig {
+    title: string;
+    noun: string;
+    isCircle?: boolean;
+    filters?: MentionFilter[];
+}
+
 export declare const Menu: default_2.FC<MenuProps>;
 
 export declare const MENU_PORTAL_CONTENT_ID = "ayon-menu-content";
@@ -1931,6 +2271,15 @@ export declare type NormalizedData = {
     icon?: string;
 };
 
+/**
+ * Clean up markdown written by the legacy quill editor:
+ * - quill wrote every line as its own paragraph and blank lines as `&nbsp;` spacer paragraphs.
+ *   When spacers are found, paragraphs next to each other become lines of one paragraph and the
+ *   spacers become paragraph breaks.
+ * - `<u>` tags are dropped (markdown has no underline)
+ */
+export declare const normalizeLegacyMarkdown: (markdown: string) => string;
+
 declare type NullableString = string | null | undefined;
 
 declare type NumberCalc = 'sum' | 'avg' | 'min' | 'max' | 'none';
@@ -2025,8 +2374,36 @@ declare type ParentColumnDefinition = {
 
 declare type ParentColumnOptionKey = 'status' | 'folderStatus' | 'folderType' | 'taskType' | 'taskStatus' | 'productType' | 'assignee' | 'tag';
 
+export declare const parseActivityLink: (href?: string | null) => ParsedActivityLink | null;
+
+/**
+ * A link to a comment (any activity) on this server: `/projects/{project}/...?activity={id}`, as
+ * made by a comment's "Copy link", or a source link (`getSourceLink`).
+ * Links to other servers stay links.
+ */
+declare type ParsedActivityLink = {
+    activityId: string;
+    entity: {
+        id: string;
+        type: string;
+    } | null;
+    isSource: true;
+} | {
+    projectName: string;
+    activityId: string;
+    entityId: string | null;
+    isSource: false;
+    url: string;
+};
+
 export declare const parseFilename: (filename: string) => string;
 
+/**
+ * The video of a YouTube url, e.g. youtube.com/watch?v=ID, youtu.be/ID, youtube.com/shorts/ID,
+ * youtube.com/embed/ID or youtube.com/live/ID. Null for anything else.
+ */
+export declare const parseYouTubeUrl: (value: string) => YouTubeVideo | null;
+
 declare type PartialBy<T, K extends keyof T> = Omit_2<T, K> & Partial<Pick<T, K>>;
 
 export declare type PathSegment = {
@@ -2070,7 +2447,7 @@ declare type PowerpackDialogType = {
     icon?: string;
 };
 
-declare type PowerpackFeature = 'slicer' | 'annotations' | 'releases' | 'advancedFilters' | 'listAttributes' | 'listFolders' | 'listAccess' | 'groupAttributes' | 'sharedViews' | 'commentCategories' | 'projectFolders' | 'columnSummaries' | 'entityLinks';
+declare type PowerpackFeature = 'slicer' | 'annotations' | 'releases' | 'advancedFilters' | 'listAttributes' | 'listFolders' | 'listAccess' | 'groupAttributes' | 'sharedViews' | 'commentCategories' | 'projectFolders' | 'columnSummaries' | 'listValues' | 'entityLinks' | 'tableExport';
 
 declare interface Processing extends ReviewableProcessingStatus {
     progress?: number;
@@ -2088,6 +2465,17 @@ declare type ProductBaseTypes = {
     definitions?: ProductBaseType[];
 };
 
+declare type ProductSuggestionItem = {
+    /** The date and time when the suggested entity was created */
+    createdAt?: string;
+    /** The relevance score of the suggestion */
+    relevance?: number;
+    id: string;
+    name: string;
+    productType: string;
+    parent?: FolderSuggestionItem;
+};
+
 declare type ProductType = {
     __typename?: 'ProductType';
     color?: Maybe<Scalars['String']['output']>;
@@ -2342,6 +2730,24 @@ declare type RemoveLinks = (links: {
     };
 }[], addToHistory?: boolean) => Promise<void>;
 
+/**
+ * For react-markdown `p` components: a paragraph that is only an image (how the editor stores
+ * image and video blocks) renders as the block. Returns null for any other paragraph.
+ */
+export declare const renderMediaParagraph: (props: {
+    node?: HastNode_2;
+}, { onOpen }?: {
+    onOpen?: (src: string) => void;
+}) => ReactNode | null;
+
+/**
+ * For react-markdown `p` components: a paragraph that is only a YouTube link (how the editor
+ * stores videos) renders as the player. Returns null for any other paragraph.
+ */
+export declare const renderYouTubeParagraph: (props: {
+    node?: HastNode;
+}) => ReactNode | null;
+
 export declare interface ReportsLoadingScreenProps extends HTMLAttributes<HTMLDivElement> {
     showSidebar?: boolean;
     sidebarConfig?: SidebarConfig;
@@ -2615,7 +3021,7 @@ declare type Scalars = {
 
 declare type Scope = ScopeType | ScopeType[];
 
-declare type ScopeType = 'folder' | 'product' | 'task' | 'user' | 'version';
+declare type ScopeType = 'folder' | 'product' | 'task' | 'user' | 'version' | 'representation';
 
 declare type ScopeType_2 = ScopeWithFilterTypes['scope'];
 
@@ -2626,6 +3032,21 @@ export declare type ScopeWithFilterTypes = {
 
 declare type SelectedViewState = ViewData | undefined;
 
+declare type SerializedMediaNode = Spread<{
+    src: string;
+    alt: string;
+    mime: string | null;
+}, SerializedDecoratorBlockNode>;
+
+declare type SerializedMentionNode = Spread<{
+    mentionType: string;
+    mentionId: string;
+}, SerializedTextNode>;
+
+declare type SerializedYouTubeNode = Spread<{
+    url: string;
+}, SerializedDecoratorBlockNode>;
+
 declare type SetDefaultViewApiArg = {
     viewType: string;
     projectName?: string;
@@ -2800,6 +3221,26 @@ declare type SlideOut = {
     projectName: string;
 };
 
+declare interface SortMenuItemArgs<T extends string> {
+    options: SortMenuOption<T>[];
+    sort: SortMenuValue<T>;
+    onChange: (sort: SortMenuValue<T>) => void;
+    id?: string;
+    label?: string;
+    icon?: string;
+}
+
+export declare interface SortMenuOption<T extends string = string> {
+    id: T;
+    label: string;
+    desc: boolean;
+}
+
+export declare interface SortMenuValue<T extends string = string> {
+    by: T;
+    desc: boolean;
+}
+
 /**
  * Splits combined Filter objects by their scope and removes the scope prefix from filter IDs.
  * Used to separate multi-scope Filter arrays back into individual scope Filter arrays.
@@ -2945,6 +3386,13 @@ export declare type SubtasksManagerWrapperProps = Omit<SubtasksManagerProps, 'up
     SubtasksManager: React.ComponentType<SubtasksManagerProps>;
 };
 
+declare type SuggestResponse = {
+    users?: UserSuggestionItem[];
+    teams?: TeamSuggestionItem[];
+    tasks?: TaskSuggestionItem[];
+    versions?: VersionSuggestionItem[];
+};
+
 export declare const sumExpectedCounts: (counts: ExpectedDeleteCounts) => number;
 
 declare type SummaryCalc = NumberCalc | BooleanCalc | TextCalc | EnumCalc | MainCalc;
@@ -3056,6 +3504,19 @@ declare type TaskProgressViewPostModel = {
     viewType?: 'taskProgress';
 };
 
+declare type TaskSuggestionItem = {
+    /** The date and time when the suggested entity was created */
+    createdAt?: string;
+    /** The relevance score of the suggestion */
+    relevance?: number;
+    id: string;
+    taskType: string;
+    name: string;
+    label?: string;
+    thumbnailId?: string;
+    parent?: FolderSuggestionItem;
+};
+
 declare type TaskType = {
     name: string;
     original_name?: string;
@@ -3082,6 +3543,14 @@ declare type TaskType_3 = {
 
 export declare const TEAM_KEY_PREFIX = "team:";
 
+declare type TeamSuggestionItem = {
+    /** The date and time when the suggested entity was created */
+    createdAt?: string;
+    /** The relevance score of the suggestion */
+    relevance?: number;
+    name: string;
+};
+
 declare type Templates = {
     version_padding?: number;
     version?: string;
@@ -3135,6 +3604,16 @@ export declare interface ThumbnailSimpleProps extends default_2.HTMLAttributes<H
     iconOnly?: boolean;
 }
 
+/**
+ * Turn the selected blocks into `format`, or back into paragraphs when they already are.
+ * Used by the toolbar and keyboard shortcuts. `set` only turns them into `format` (slash menu).
+ */
+export declare const toggleBlockFormat: (editor: LexicalEditor, format: BlockFormat, mode?: "toggle" | "set") => void;
+
+export declare type ToolbarItem = 'h1' | 'h2' | 'h3' | 'bold' | 'italic' | 'strikethrough' | 'code' | 'link' | 'codeBlock' | 'quote' | 'numberList' | 'bulletList' | 'checkList';
+
+export declare type ToolbarLayout = (ToolbarItem | '|')[];
+
 declare type TopicUpdateType = 'created' | 'label_changed' | 'renamed' | 'type_changed' | 'status_changed' | 'tags_changed' | 'attrib_changed' | 'deleted';
 
 declare type UpdateEntitiesArgs = {
@@ -3173,6 +3652,12 @@ declare type UpdateViewApiArg = {
 
 declare type UpdateViewSettingsFn = (updatedSettings: any, localStateSetter: (value: any) => void, newLocalValue: any, options: UpdateOptions) => Promise<void>;
 
+export declare interface UploadedMedia {
+    src: string;
+    name?: string;
+    mime?: string;
+}
+
 export declare interface UploadHandlers {
     handleFileUpload: (files: FileList | File[], versionId?: string) => Promise<void>;
     handleRemoveUpload: (name: string) => void;
@@ -3181,6 +3666,8 @@ export declare interface UploadHandlers {
     };
 }
 
+export declare type UploadMedia = (file: File) => Promise<UploadedMedia>;
+
 export declare const UploadVersionDialog: FC<UploadVersionDialogProps>;
 
 declare interface UploadVersionDialogProps {
@@ -3276,6 +3763,15 @@ declare type UserModel = {
     updatedAt?: string;
 };
 
+declare type UserSuggestionItem = {
+    /** The date and time when the suggested entity was created */
+    createdAt?: string;
+    /** The relevance score of the suggestion */
+    relevance?: number;
+    name: string;
+    fullName?: string;
+};
+
 export declare const useUpdateLinks: ({ projectName, direction, entityId, entityType, targetEntityType, linkType, }: Props) => {
     remove: RemoveLinks;
     add: AddLinks;
@@ -3490,6 +3986,17 @@ declare type VersionsSettings = {
     columns?: ColumnItemModel[];
 };
 
+declare type VersionSuggestionItem = {
+    /** The date and time when the suggested entity was created */
+    createdAt?: string;
+    /** The relevance score of the suggestion */
+    relevance?: number;
+    id: string;
+    version: number;
+    parent?: ProductSuggestionItem;
+    name?: string;
+};
+
 declare type VersionsViewModel = {
     /** Unique identifier for the view within the given scope. */
     id?: string;
@@ -3798,6 +4305,37 @@ declare type WorkTemplate = {
     file: string;
 };
 
+export declare const YouTubeEmbed: ({ video, className }: YouTubeEmbedProps) => JSX_2.Element;
+
+declare interface YouTubeEmbedProps {
+    video: YouTubeVideo;
+    className?: string;
+}
+
+/**
+ * An embedded YouTube video. Stored in markdown as the video url on its own line, which the
+ * comment renderer shows as the player (and anything else as a link).
+ */
+export declare class YouTubeNode extends DecoratorBlockNode {
+    __url: string;
+    static getType(): string;
+    static clone(node: YouTubeNode): YouTubeNode;
+    static importJSON(serializedNode: SerializedYouTubeNode): YouTubeNode;
+    constructor(url: string, format?: ElementFormatType, key?: NodeKey);
+    exportJSON(): SerializedYouTubeNode;
+    exportDOM(): DOMExportOutput;
+    static importDOM(): DOMConversionMap | null;
+    updateDOM(): false;
+    getUrl(): string;
+    getTextContent(): string;
+    decorate(_editor: LexicalEditor, config: EditorConfig): JSX_3.Element;
+}
+
+declare interface YouTubeVideo {
+    id: string;
+    start?: number;
+}
+
 
 export * from "primereact/confirmdialog";