@ynput/ayon-frontend-shared 0.7.6 → 0.8.1

package/dist/types/components.d.ts

@@ -24,6 +24,7 @@ import { DropdownRef } from '@ynput/ayon-react-components';
 import { EditorConfig } from 'lexical';
 import { ElementFormatType } from 'lexical';
 import { ElementNode } from 'lexical';
+import { EntityCardProps } from '@ynput/ayon-react-components';
 import { ExecutionProps } from 'styled-components';
 import { FastOmit } from 'styled-components';
 import { FC } from 'react';
@@ -279,6 +280,22 @@ declare interface AddonUser {
     isDeveloper: boolean
 }
 
+/** The addons' sections, each in a panel titled like AYON's own. */
+export declare const AddonUserDetailsSections: ({ context }: AddonUserDetailsSectionsProps) => JSX_2.Element;
+
+declare interface AddonUserDetailsSectionsProps {
+    context: UserDetailsContext;
+}
+
+export declare interface AddonUserMenuItems {
+    /** first in the menu (`position: 'top'`) */
+    topItems: MenuItemType[];
+    /** after the menu's own items, above Delete */
+    items: MenuItemType[];
+    /** loads the items' code: call it when the menu opens */
+    prefetch: () => void;
+}
+
 declare type AlignType = 'left' | 'right';
 
 declare type Anatomy = {
@@ -289,7 +306,9 @@ declare type Anatomy = {
     /** Path templates configuration */
     templates?: Templates;
     /** Attributes configuration */
-    attributes?: ProjectAttribModel;
+    attributes?: {
+        [key: string]: any;
+    };
     /** Folder types configuration */
     folder_types?: FolderType[];
     /** Task types configuration */
@@ -339,36 +358,40 @@ declare type AttributeData_2 = {
     /** Type of attribute value */
     type?: 'string' | 'integer' | 'float' | 'boolean' | 'datetime' | 'list_of_strings' | 'list_of_integers' | 'list_of_any' | 'list_of_submodels' | 'dict';
     /** Nice, human readable title of the attribute */
-    title?: string;
-    description?: string;
+    title?: string | null;
+    description?: string | null;
     /** Example value of the field. */
     example?: any;
     /** Default value for the attribute. Do not set for list types. */
     default?: any;
-    gt?: number | number;
-    ge?: number | number;
-    lt?: number | number;
-    le?: number | number;
-    minLength?: number;
-    maxLength?: number;
+    gt?: number | number | null;
+    ge?: number | number | null;
+    lt?: number | number | null;
+    le?: number | number | null;
+    minLength?: number | null;
+    maxLength?: number | null;
     /** Minimum number of items in list type. */
-    minItems?: number;
+    minItems?: number | null;
     /** Only for list types. Maximum number of items in the list. */
-    maxItems?: number;
+    maxItems?: number | null;
     /** Only for string types. The value must match this regex. */
-    regex?: string;
+    regex?: string | null;
     /** List of enum items used for displaying select widgets */
-    enum?: EnumItem[];
+    enum?: EnumItem[] | null;
     /** Name of the function that provides enum values dynamically. */
-    enumResolver?: string;
+    enumResolver?: string | null;
     /** Settings passed to the enum resolver function. */
-    enumResolverSettings?: object;
+    enumResolverSettings?: {
+        [key: string]: any;
+    } | null;
     /** Inherit the attribute value from the parent entity. */
     inherit?: boolean;
     /** Specific widget style this field should use. */
-    widget?: string;
+    widget?: string | null;
     /** Any additional config specific for the widget style.(Date formats, precision etc.) */
-    widgetSettings?: object;
+    widgetSettings?: {
+        [key: string]: any;
+    } | null;
 };
 
 declare type AttributeDataValue = AttributeType | null | undefined;
@@ -577,13 +600,6 @@ declare interface ColumnHeaderMenuUIProps {
 
 declare type ColumnIdAliases = Record<string, string>;
 
-declare type ColumnItemModel = {
-    name: string;
-    visible?: boolean;
-    pinned?: boolean;
-    width?: number;
-};
-
 export declare const ColumnMenuButton: IStyledComponentBase<"web", FastOmit< FastOmit<Omit< ButtonProps & RefAttributes<HTMLButtonElement>, "ref"> & {
     ref?: ((instance: HTMLButtonElement | 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<HTMLButtonElement> | null | undefined;
 }, "$isOpen"> & {
@@ -731,8 +747,8 @@ export declare const createFeedMentionSource: ({ suggestions, project, taskTypes
 
 declare type CreateViewApiArg = {
     viewType: string;
-    projectName?: string;
-    payload: OverviewViewPostModel | TaskProgressViewPostModel | ListsViewPostModel | ReviewsViewPostModel | VersionsViewPostModel | GenericViewPostModel;
+    projectName?: string | null;
+    genericViewPostModel: GenericViewPostModel;
 };
 
 export declare const CUSTOM_RANGE_ICON = "tune";
@@ -888,7 +904,7 @@ export declare type DeleteEntitiesConfirmDialogProps = {
 declare type DeleteViewApiArg = {
     viewType: string;
     viewId: string;
-    projectName?: string;
+    projectName?: string | null;
 };
 
 declare type DeliveryTemplate = {
@@ -1043,6 +1059,8 @@ declare type DetailsPanelEntityData = {
     status: string;
     updatedAt: string;
     createdAt: string;
+    createdBy?: string | null;
+    updatedBy?: string | null;
     thumbnailHash: string;
     attrib: Record<string, string | number>;
     hasReviewables?: boolean;
@@ -1166,6 +1184,10 @@ declare interface DetailsSectionProps {
     form: Record<string, any>;
     mixedFields?: string[];
     isLoading: boolean;
+    users?: {
+        name: string;
+        fullName?: string | null;
+    }[];
 }
 
 /**
@@ -1289,17 +1311,21 @@ declare type EntityListItemModel = {
     /** Position of the item in the list */
     position: number;
     /** Label of the item */
-    label?: string;
+    label?: string | null;
     /** Overrides of the listed entity attributes */
-    attrib?: object;
+    attrib?: {
+        [key: string]: any;
+    };
     /** Additional data associated with the item */
-    data?: Record<string, any>;
+    data?: {
+        [key: string]: any;
+    };
     /** Tags associated with the item */
     tags?: string[];
     /** Path to the folder where the item is located */
     folderPath: string;
-    createdBy?: string;
-    updatedBy?: string;
+    createdBy?: string | null;
+    updatedBy?: string | null;
     createdAt?: string;
     updatedAt?: string;
 };
@@ -1309,7 +1335,7 @@ declare type EntityListModel = {
     /** Type of the list */
     entityListType: string;
     /** ID of the folder containing the list */
-    entityListFolderId?: string;
+    entityListFolderId?: string | null;
     /** Type of the entity that can be included in the list */
     entityType: 'folder' | 'product' | 'version' | 'representation' | 'task' | 'workfile';
     label: string;
@@ -1318,17 +1344,23 @@ declare type EntityListModel = {
         [key: string]: ListAccessLevel;
     };
     /** List attributes */
-    attrib?: object;
+    attrib?: {
+        [key: string]: any;
+    };
     /** Additional data associated with the list */
-    data?: Record<string, any>;
-    template?: object;
+    data?: {
+        [key: string]: any;
+    };
+    template?: {
+        [key: string]: any;
+    };
     /** List tags */
     tags?: string[];
     items?: EntityListItemModel[];
     /** Name of the user who created the list */
-    owner?: string;
-    createdBy?: string;
-    updatedBy?: string;
+    owner?: string | null;
+    createdBy?: string | null;
+    updatedBy?: string | null;
     createdAt?: string;
     updatedAt?: string;
     /** Whether the list is active or not */
@@ -1509,19 +1541,21 @@ export declare interface EnumEditorPt {
 declare type EnumItem = {
     value: string | number | number | boolean;
     label: string;
-    description?: string;
-    fulltext?: string[];
-    group?: string;
+    description?: string | null;
+    fulltext?: string[] | null;
+    group?: string | null;
     /** Icon name (material symbol) or IconModel object */
-    icon?: string | IconModel;
-    color?: string;
-    shortName?: string;
+    icon?: string | IconModel | null;
+    color?: string | null;
+    shortName?: string | null;
     /** Enum item is visible, but not selectable */
     disabled?: boolean;
     /** Message to show when the option is disabled */
-    disabledMessage?: string;
-    /** Enum item is not offered for selection, but resolves when already used */
+    disabledMessage?: string | null;
+    /** Enum item is not visible in the dropdown */
     hidden?: boolean;
+    /** Extra badge labels to display next to the item */
+    badges?: string[] | null;
 };
 
 declare const EnumItemBody: IStyledComponentBase<"web", FastOmit<DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never> & Partial<Pick< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>>> & string;
@@ -1627,9 +1661,58 @@ export declare const FileThumbnail: FC<FileThumbnailProps>;
 export declare interface FileThumbnailProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onError' | 'onLoad'> {
     src: string;
     mimetype?: string;
+    /** hover-scrub filmstrip url (see getFileFilmstripUrl) */
+    filmstripSrc?: string | null;
     imgProps?: Omit<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'onError' | 'onLoad'>;
 }
 
+/**
+ * Hover-scrub preview of a video thumbnail.
+ *
+ * Render it as the last child of a positioned thumbnail element. While the cursor is over
+ * that element, the overlay shows the filmstrip frame matching the cursor position,
+ * so moving the cursor left to right "plays" the video.
+ */
+export declare const Filmstrip: FC<FilmstripProps>;
+
+export declare const FILMSTRIP_ACTIVE_ATTRIBUTE = "data-filmstrip-active";
+
+export declare const FILMSTRIP_FILE_ATTRIBUTE = "data-filmstrip-file-id";
+
+export declare const FILMSTRIP_POSITION_ATTRIBUTE = "data-filmstrip-position";
+
+export declare interface FilmstripData {
+    fileId: string;
+    url: string;
+    frames: number;
+    columns: number;
+    frameWidth: number;
+    frameHeight: number;
+}
+
+/** ARC EntityCard with a hover-scrub filmstrip */
+export declare const FilmstripEntityCard: ForwardRefExoticComponent<FilmstripEntityCardProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface FilmstripEntityCardProps extends EntityCardProps {
+    /** hover-scrub filmstrip url (see getEntityFilmstripUrl) */
+    filmstripUrl?: string | null;
+}
+
+export declare interface FilmstripProps {
+    /** Filmstrip URL (see getEntityFilmstripUrl). Nothing happens when empty. */
+    src?: string | null;
+    /** Should match object-fit of the static thumbnail underneath */
+    fit?: 'cover' | 'contain';
+    disabled?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+
+export declare interface FilmstripTarget {
+    position: number;
+    fileId: string;
+}
+
 export declare const FILTER_TYPES_BY_SCOPE: Record<ScopeType_2, FilterFieldType[]>;
 
 declare type FilterConfig = {
@@ -1749,19 +1832,19 @@ declare interface FolderProduct {
 
 declare type FolderSuggestionItem = {
     /** The date and time when the suggested entity was created */
-    createdAt?: string;
+    createdAt?: string | null;
     /** The relevance score of the suggestion */
-    relevance?: number;
+    relevance?: number | null;
     id: string;
     folderType: string;
     name: string;
-    label?: string;
-    thumbnailId?: string;
+    label?: string | null;
+    thumbnailId?: string | null;
 };
 
 declare type FolderType = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -1769,7 +1852,7 @@ declare type FolderType = {
 
 declare type FolderType_2 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -1783,29 +1866,40 @@ declare interface FormData_2 {
 export { FormData_2 as FormData }
 
 declare type FormFieldPatch = {
-    value?: string | number | number | boolean | string[] | number[] | number[] | null;
+    value?: string | number | number | boolean | string[] | number[] | number[] | FormFileData | null;
     label?: string;
     placeholder?: any;
     options?: FormOptionItem[];
-    readOnly?: boolean;
-    disabled?: boolean;
+    enum_resolver?: string;
+    enum_resolver_params?: {
+        [key: string]: any;
+    };
+    read_only?: boolean;
     hidden?: boolean;
+    disabled?: boolean;
     highlight?: 'info' | 'warning' | 'error';
 };
 
 declare type FormFieldRule = {
-    when: QueryFilter;
+    /** Filter source events */
+    when: QueryFilter_2;
     set: FormFieldPatch;
 };
 
-declare interface FormFileData {
+declare type FormFileData = {
+    filename: string;
+    payload: string;
+    download?: boolean;
+};
+
+declare interface FormFileData_2 {
     payload: string;
     filename: string;
     download?: boolean;
 }
 
 declare type FormOptionItem = {
-    value: string | number | boolean;
+    value: string | number | number | boolean;
     label?: string;
     description?: string;
     group?: string;
@@ -1847,16 +1941,22 @@ declare type GenericViewModel = {
     working: boolean;
     position: number;
     accessLevel: number;
-    settings: object;
-    access: object;
     viewType: string;
+    settings: {
+        [key: string]: any;
+    };
+    access: {
+        [key: string]: any;
+    };
 };
 
 declare type GenericViewPatchModel = {
-    label?: string;
-    owner?: string;
-    settings?: object;
-    viewType: string;
+    label?: string | null;
+    owner?: string | null;
+    viewType?: string | null;
+    settings?: {
+        [key: string]: any;
+    } | null;
 };
 
 declare type GenericViewPostModel = {
@@ -1866,29 +1966,25 @@ declare type GenericViewPostModel = {
     label: string;
     /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
     working?: boolean;
-    settings: object;
-    viewType: string;
+    viewType?: string | null;
+    settings: {
+        [key: string]: any;
+    };
 };
 
 declare type GetBaseViewApiArg = {
     viewType: string;
-    projectName?: string;
+    projectName?: string | null;
 };
 
-declare type GetBaseViewApiResponse = 
-/** status 200 Successful Response */
-OverviewViewModel | TaskProgressViewModel | ListsViewModel | ReviewsViewModel | VersionsViewModel | GenericViewModel;
-
 export declare const getButtonAction: (contribution: AnyContribution) => ButtonAction | undefined;
 
 declare type GetDefaultViewApiArg = {
     viewType: string;
-    projectName?: string;
+    projectName?: string | null;
 };
 
-declare type GetDefaultViewApiResponse = 
-/** status 200 Successful Response */
-OverviewViewModel | TaskProgressViewModel | ListsViewModel | ReviewsViewModel | VersionsViewModel | GenericViewModel;
+declare type GetDefaultViewApiResponse = GenericViewModel;
 
 declare type GetDetailsPanelTaskQuery = {
     project: {
@@ -1905,6 +2001,8 @@ declare type GetDetailsPanelTaskQuery = {
             assignees: Array<string>;
             updatedAt: unknown;
             createdAt: unknown;
+            createdBy: string | null;
+            updatedBy: string | null;
             thumbnailHash: string;
             folderId: string;
             thumbnailId: string | null;
@@ -1946,6 +2044,15 @@ declare type GetDetailsPanelTaskQuery = {
     };
 };
 
+/**
+ * The filmstrip frame shown under the cursor, for opening the viewer at the same reviewable
+ * and frame the user was looking at.
+ * Returns undefined when the event did not come from a scrubbed thumbnail.
+ */
+export declare const getFilmstripTarget: (event?: {
+    target: EventTarget | null;
+}) => FilmstripTarget | undefined;
+
 export declare const getGroupedReviewables: (reviewables: ReviewableResponse[], hasTranscoder?: boolean | undefined) => {
     playable: ReviewableResponse[];
     incompatible: ReviewableResponse[];
@@ -1991,22 +2098,14 @@ export declare const getUiTypeLabel: (type: AttributeData_2["type"] | undefined,
 declare type GetViewApiArg = {
     viewType: string;
     viewId: string;
-    projectName?: string;
+    projectName?: string | null;
 };
 
-declare type GetViewApiResponse = 
-/** status 200 Successful Response */
-OverviewViewModel | TaskProgressViewModel | ListsViewModel | ReviewsViewModel | VersionsViewModel | GenericViewModel;
-
 declare type GetWorkingViewApiArg = {
     viewType: string;
-    projectName?: string;
+    projectName?: string | null;
 };
 
-declare type GetWorkingViewApiResponse = 
-/** status 200 Successful Response */
-OverviewViewModel | TaskProgressViewModel | ListsViewModel | ReviewsViewModel | VersionsViewModel | GenericViewModel;
-
 declare interface GridConfig {
     columns: number;
     rows: number;
@@ -2102,21 +2201,21 @@ declare type IconInputPt = Partial<React.ComponentProps<typeof Styled.IconSelect
 declare type IconModel = {
     type?: 'material-symbols' | 'url';
     /** The name of the icon (for type material-symbols) */
-    name?: string;
+    name?: string | null;
     /** The color of the icon (for type material-symbols) */
-    color?: string;
+    color?: string | null;
     /** The URL of the icon (for type url) */
-    url?: string;
+    url?: string | null;
 };
 
 declare type IconModel_2 = {
     type?: 'material-symbols' | 'url';
     /** The name of the icon (for type material-symbols) */
-    name?: string;
+    name?: string | null;
     /** The color of the icon (for type material-symbols) */
-    color?: string;
+    color?: string | null;
     /** The URL of the icon (for type url) */
-    url?: string;
+    url?: string | null;
 };
 
 declare const IconSelect: IStyledComponentBase<"web", FastOmit<Omit< IconSelectProps & RefAttributes<DropdownRef>, "ref"> & {
@@ -2234,7 +2333,7 @@ declare type LinkType = {
     link_type: string;
     input_type: 'folder' | 'product' | 'version' | 'representation' | 'task' | 'workfile';
     output_type: 'folder' | 'product' | 'version' | 'representation' | 'task' | 'workfile';
-    color?: string;
+    color?: string | null;
     style?: 'solid' | 'dashed';
 };
 
@@ -2248,7 +2347,9 @@ declare type LinkTypeModel_2 = {
     /** Output entity type */
     outputType: string;
     /** Additional link type data */
-    data?: object;
+    data?: {
+        [key: string]: any;
+    };
 };
 
 declare type ListAccessLevel = 0 | 10 | 20 | 30;
@@ -2275,55 +2376,9 @@ declare interface ListMetaDataProps {
     isLoading?: boolean;
 }
 
-declare type ListsSettings = {
-    rowHeight?: number;
-    sortBy?: string | string[];
-    sortDesc?: boolean;
-    filter?: QueryFilter_5;
-    columns?: ColumnItemModel[];
-};
-
-declare type ListsViewModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Determines whether the view is only available for the given project or for all projects (studio). */
-    scope: 'project' | 'studio';
-    /** Name of the user who created the view. Owners have full control over the view,  */
-    owner: string;
-    /** Visibility of the view. Public views are visible to all users, private views are only visible to the owner. */
-    visibility: 'public' | 'private';
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working: boolean;
-    position: number;
-    accessLevel: number;
-    settings: ListsSettings;
-    access: object;
-    viewType?: 'lists';
-};
-
-declare type ListsViewPatchModel = {
-    label?: string;
-    owner?: string;
-    settings?: ListsSettings;
-    viewType?: 'lists';
-};
-
-declare type ListsViewPostModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working?: boolean;
-    settings: ListsSettings;
-    viewType?: 'lists';
-};
-
 declare type ListViewsApiArg = {
     viewType: string;
-    projectName?: string;
+    projectName?: string | null;
 };
 
 /**
@@ -2332,6 +2387,9 @@ declare type ListViewsApiArg = {
  */
 declare type Loader<T> = () => Promise<{ default: T }>
 
+/** Loads a filmstrip, deduplicating concurrent and repeated requests until it expires */
+export declare const loadFilmstrip: (src: string) => Promise<FilmstripData | null>;
+
 export declare const LoginPage: ({ onLogin, loading, isFirstTime }: LoginPageProps) => JSX_2.Element | null;
 
 export declare interface LoginPageProps {
@@ -2724,66 +2782,16 @@ declare type OperationModel = {
     id?: string;
     type: 'create' | 'update' | 'delete';
     entityType: 'folder' | 'product' | 'version' | 'representation' | 'task' | 'workfile';
-    entityId?: string;
-    data?: Record<string, any>;
+    entityId?: string | null;
+    data?: {
+        [key: string]: any;
+    } | null;
     force?: boolean;
-    asUser?: string;
-};
-
-declare type OverviewSettings = {
-    showHierarchy?: boolean;
-    rowHeight?: number;
-    groupBy?: string;
-    groupSortByDesc?: boolean;
-    showEmptyGroups?: boolean;
-    sortBy?: string | string[];
-    sortDesc?: boolean;
-    filter?: QueryFilter_5;
-    folderFilter?: QueryFilter_5;
-    sliceType?: string;
-    columns?: ColumnItemModel[];
+    asUser?: string | null;
 };
 
 export declare type OverviewSettingsChange = (setting: 'columns' | 'group-by', value: any) => void;
 
-declare type OverviewViewModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Determines whether the view is only available for the given project or for all projects (studio). */
-    scope: 'project' | 'studio';
-    /** Name of the user who created the view. Owners have full control over the view,  */
-    owner: string;
-    /** Visibility of the view. Public views are visible to all users, private views are only visible to the owner. */
-    visibility: 'public' | 'private';
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working: boolean;
-    position: number;
-    accessLevel: number;
-    settings: OverviewSettings;
-    access: object;
-    viewType?: 'overview';
-};
-
-declare type OverviewViewPatchModel = {
-    label?: string;
-    owner?: string;
-    settings?: OverviewSettings;
-    viewType?: 'overview';
-};
-
-declare type OverviewViewPostModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working?: boolean;
-    settings: OverviewSettings;
-    viewType?: 'overview';
-};
-
 /** Description of a page contribution (`project.page`, `studio.page`). */
 declare interface PageMeta {
     /**
@@ -2877,6 +2885,12 @@ export declare type PathSegment = {
     id: string;
 };
 
+/**
+ * Returns a loaded filmstrip that is still valid: data, `null` (not available)
+ * or `undefined` (not loaded, expired or evicted - call loadFilmstrip)
+ */
+export declare const peekFilmstrip: (src: string) => FilmstripData | null | undefined;
+
 /** What `EntityPicker` picks. */
 declare type PickableEntityType = 'folder' | 'task' | 'product' | 'version' | 'representation' | 'workfile'
 
@@ -2952,13 +2966,13 @@ declare type ProductBaseTypes = {
 
 declare type ProductSuggestionItem = {
     /** The date and time when the suggested entity was created */
-    createdAt?: string;
+    createdAt?: string | null;
     /** The relevance score of the suggestion */
-    relevance?: number;
+    relevance?: number | null;
     id: string;
     name: string;
     productType: string;
-    parent?: FolderSuggestionItem;
+    parent?: FolderSuggestionItem | null;
 };
 
 declare type ProductType = {
@@ -2970,55 +2984,9 @@ declare type ProductType = {
 
 declare type ProductTypeListItem = {
     name: string;
-    baseType?: string;
-    color?: string;
-    icon?: string;
-};
-
-declare type ProjectAttribModel = {
-    priority?: 'urgent' | 'high' | 'normal' | 'low';
-    /** Frame rate */
-    fps?: number;
-    /** Horizontal resolution */
-    resolutionWidth?: number;
-    /** Vertical resolution */
-    resolutionHeight?: number;
-    pixelAspect?: number;
-    clipIn?: number;
-    clipOut?: number;
-    frameStart?: number;
-    frameEnd?: number;
-    handleStart?: number;
-    handleEnd?: number;
-    /** Date and time when the project or task or asset was started */
-    startDate?: string;
-    /** Deadline date and time */
-    endDate?: string;
-    /** Textual description of the entity */
-    description?: string;
-};
-
-declare type ProjectAttribModel2 = {
-    priority?: 'urgent' | 'high' | 'normal' | 'low';
-    /** Frame rate */
-    fps?: number;
-    /** Horizontal resolution */
-    resolutionWidth?: number;
-    /** Vertical resolution */
-    resolutionHeight?: number;
-    pixelAspect?: number;
-    clipIn?: number;
-    clipOut?: number;
-    frameStart?: number;
-    frameEnd?: number;
-    handleStart?: number;
-    handleEnd?: number;
-    /** Date and time when the project or task or asset was started */
-    startDate?: string;
-    /** Deadline date and time */
-    endDate?: string;
-    /** Textual description of the entity */
-    description?: string;
+    baseType?: string | null;
+    color?: string | null;
+    icon?: string | null;
 };
 
 declare interface ProjectContextValue extends ProjectModelWithProducts {
@@ -3090,22 +3058,30 @@ declare interface ProjectListMenuItemContext {
 }
 
 declare type ProjectModel = {
-    /** Name is an unique id of the {entity_name} */
+    /** Unique name of the project */
     name: string;
     code: string;
-    label?: string;
+    label?: string | null;
     library?: boolean;
     folderTypes?: FolderType_2[];
     taskTypes?: TaskType_2[];
     linkTypes?: LinkTypeModel_2[];
     statuses?: Status_2[];
     tags?: Tag_2[];
-    config?: object;
-    skeleton?: boolean;
-    attrib?: ProjectAttribModel2;
-    data?: object;
-    /** Whether the project is active */
+    config?: {
+        [key: string]: any;
+    };
+    skeleton?: boolean | null;
+    /** Attribute values of the entity */
+    attrib?: {
+        [key: string]: any;
+    };
+    data?: {
+        [key: string]: any;
+    };
+    /** Whether the entity is active */
     active?: boolean;
+    /** List of attributes explicitly set on the entity itself (not inherited) */
     ownAttrib?: string[];
     /** Time of creation */
     createdAt?: string;
@@ -3130,6 +3106,15 @@ declare interface ProjectPageLayoutProps {
     children: ReactNode
 }
 
+/** Description of a `project.page` contribution: a page, and what the host adds around it. */
+declare interface ProjectPageMeta extends PageMeta {
+    /**
+     * Shows AYON's details panel next to the page, for the page to open with `openDetails`. The page
+     * is in a splitter while the panel is there; it only shows when the page opens it.
+     */
+    detailsPanel?: boolean
+}
+
 export declare const ProjectPageRemote: FC<ProjectPageRemoteProps>;
 
 export declare interface ProjectPageRemoteProps extends RemotePageWrapperProps {
@@ -3230,18 +3215,18 @@ declare type QueryCondition = {
     /** Path to the key separated by slashes */
     key: string;
     /** Value to compare against */
-    value?: string | number | number | boolean | string[] | number[] | number[];
-    /** Comparison operator */
-    operator?: 'eq' | 'like' | 'notlike' | 'lt' | 'gt' | 'lte' | 'gte' | 'ne' | 'isnull' | 'notnull' | 'in' | 'notin' | 'includes' | 'excludes' | 'includesall' | 'excludesall' | 'includesany' | 'excludesany';
+    value?: string | number | number | boolean | string[] | number[] | number[] | null;
+    /** Comparison operator. like and notlike perform case-insensitive substring matching. One surrounding pair of % is treated as a substring wrapper; %, _ and backslashes within it are literal. */
+    operator?: 'eq' | 'like' | 'notlike' | 're' | 'lt' | 'gt' | 'lte' | 'gte' | 'ne' | 'isnull' | 'notnull' | 'in' | 'notin' | 'includes' | 'excludes' | 'includesall' | 'excludesall' | 'includesany' | 'excludesany';
 };
 
-declare type QueryCondition_5 = {
+declare type QueryCondition_2 = {
     /** Path to the key separated by slashes */
     key: string;
     /** Value to compare against */
-    value?: string | number | number | boolean | string[] | number[] | number[];
-    /** Comparison operator */
-    operator?: 'eq' | 'like' | 'notlike' | 'lt' | 'gt' | 'lte' | 'gte' | 'ne' | 'isnull' | 'notnull' | 'in' | 'notin' | 'includes' | 'excludes' | 'includesall' | 'excludesall' | 'includesany' | 'excludesany';
+    value?: string | number | number | boolean | string[] | number[] | number[] | null;
+    /** Comparison operator. like and notlike perform case-insensitive substring matching. One surrounding pair of % is treated as a substring wrapper; %, _ and backslashes within it are literal. */
+    operator?: 'eq' | 'like' | 'notlike' | 're' | 'lt' | 'gt' | 'lte' | 'gte' | 'ne' | 'isnull' | 'notnull' | 'in' | 'notin' | 'includes' | 'excludes' | 'includesall' | 'excludesall' | 'includesany' | 'excludesany';
 };
 
 declare type QueryFilter = {
@@ -3251,9 +3236,9 @@ declare type QueryFilter = {
     operator?: 'and' | 'or';
 };
 
-declare type QueryFilter_5 = {
+declare type QueryFilter_2 = {
     /** List of conditions to be evaluated */
-    conditions?: (QueryCondition_5 | QueryFilter_5)[];
+    conditions?: (QueryCondition_2 | QueryFilter_2)[];
     /** Operator to use when joining conditions */
     operator?: 'and' | 'or';
 };
@@ -3360,7 +3345,7 @@ declare type RequiredAddonVersionProps = BaseProps & ({
 
 declare type ReviewableAuthor = {
     name: string;
-    fullName?: string;
+    fullName?: string | null;
 };
 
 export declare const ReviewableCard: ForwardRefExoticComponent<ReviewableCardProps & RefAttributes<HTMLDivElement>>;
@@ -3386,20 +3371,22 @@ declare type ReviewableModel = {
     fileId: string;
     activityId: string;
     filename: string;
-    label?: string;
+    label?: string | null;
     mimetype: string;
     availability?: 'unknown' | 'conversionRequired' | 'conversionRecommended' | 'ready';
-    mediaInfo?: object;
-    createdFrom?: string;
+    mediaInfo?: {
+        [key: string]: any;
+    } | null;
+    createdFrom?: string | null;
     /** Information about the processing status */
-    processing?: ReviewableProcessingStatus;
+    processing?: ReviewableProcessingStatus | null;
     createdAt?: string;
     updatedAt?: string;
     author: ReviewableAuthor;
 };
 
 declare type ReviewableProcessingStatus = {
-    eventId?: string;
+    eventId?: string | null;
     status: string;
     description: string;
 };
@@ -3492,54 +3479,6 @@ export declare interface ReviewableUploadProps extends React.HTMLProps<HTMLDivEl
     };
 }
 
-declare type ReviewsSettings = {
-    rowHeight?: number;
-    sortBy?: string | string[];
-    sortDesc?: boolean;
-    filter?: QueryFilter_5;
-    columns?: ColumnItemModel[];
-    gridHeight?: number;
-    displayStyle?: 'cards' | 'table' | 'playlist';
-};
-
-declare type ReviewsViewModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Determines whether the view is only available for the given project or for all projects (studio). */
-    scope: 'project' | 'studio';
-    /** Name of the user who created the view. Owners have full control over the view,  */
-    owner: string;
-    /** Visibility of the view. Public views are visible to all users, private views are only visible to the owner. */
-    visibility: 'public' | 'private';
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working: boolean;
-    position: number;
-    accessLevel: number;
-    settings: ReviewsSettings;
-    access: object;
-    viewType?: 'reviews';
-};
-
-declare type ReviewsViewPatchModel = {
-    label?: string;
-    owner?: string;
-    settings?: ReviewsSettings;
-    viewType?: 'reviews';
-};
-
-declare type ReviewsViewPostModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working?: boolean;
-    settings: ReviewsSettings;
-    viewType?: 'reviews';
-};
-
 declare type Root = {
     name: string;
     windows?: string;
@@ -3640,7 +3579,7 @@ declare type SerializedYouTubeNode = Spread<{
 
 declare type SetDefaultViewApiArg = {
     viewType: string;
-    projectName?: string;
+    projectName?: string | null;
     setDefaultViewRequestModel: SetDefaultViewRequestModel;
 };
 
@@ -3708,7 +3647,7 @@ declare type ShareOption = {
     value: string;
     name: string;
     label: string;
-    attribute?: string;
+    attribute?: string | null;
 };
 
 export declare const ShareOptionIcon: FC<ShareOptionIconProps>;
@@ -3741,6 +3680,9 @@ declare type ShortcutKeyEvent = Pick<KeyboardEvent, 'key' | 'code' | 'ctrlKey' |
  */
 declare type ShortcutTable = ProjectTablePage | 'slicer' | 'projects' | 'listsPanel' | 'versionsPanel'
 
+/** A contribution with this `selection` shows for `count` selected users. */
+export declare const showsForSelection: (selection: UserSelection | undefined, count: number) => boolean;
+
 declare interface SidebarConfig {
     width?: string;
     minWidth?: string;
@@ -3784,7 +3726,7 @@ declare type SimpleFormField = {
     name: string;
     label?: string;
     placeholder?: any;
-    value?: string | number | number | boolean | string[] | number[] | number[];
+    value?: string | number | number | boolean | string[] | number[] | number[] | FormFileData;
     regex?: string;
     multiline?: boolean;
     syntax?: string;
@@ -3793,7 +3735,7 @@ declare type SimpleFormField = {
     min?: number | number;
     max?: number | number;
     valid_extensions?: string[];
-    readOnly?: boolean;
+    read_only?: boolean;
     disabled?: boolean;
     hidden?: boolean;
     enum_resolver?: string;
@@ -3814,7 +3756,7 @@ export declare interface SimpleFormProps {
     style?: default_2.CSSProperties;
 }
 
-export declare type SimpleFormValue = string | number | boolean | string[] | number[] | FormFileData | null | undefined;
+export declare type SimpleFormValue = string | number | boolean | string[] | number[] | FormFileData_2 | null | undefined;
 
 export declare type SimpleFormValueDict = Record<string, SimpleFormValue>;
 
@@ -3895,7 +3837,7 @@ declare interface SlotMap {
      */
     'project.page': {
         version: 1
-        meta: PageMeta
+        meta: ProjectPageMeta
         context: ProjectScope & SlicerScope & ProjectFoldersScope & ViewsScope
         pieces: { component: Loader<ComponentType<SlotProps<'project.page'>>> }
     }
@@ -4025,6 +3967,27 @@ declare interface SlotMap {
         context: TableShortcutContext
         pieces: TableShortcutPieces
     }
+    /**
+     * A section in the user details panel (Settings → Users), below AYON's own forms, for the
+     * selected users. The section shows from the description, titled like AYON's; `component`
+     * loads when it is first shown. Saving is the section's own: AYON's Save button doesn't see it.
+     */
+    'userDetails.section': {
+        version: 1
+        meta: UserDetailsSectionMeta
+        context: UserDetailsContext
+        pieces: { component: Loader<ComponentType<SlotProps<'userDetails.section'>>> }
+    }
+    /**
+     * An item in the user details panel's "more" menu (Settings → Users), for the selected users.
+     * It shows from the description; `run` loads when the menu opens and is called on click.
+     */
+    'userDetails.menuItem': {
+        version: 1
+        meta: UserDetailsMenuItemMeta
+        context: UserDetailsContext
+        pieces: { run: Loader<RunPiece<'userDetails.menuItem'>> }
+    }
     /**
      * Code with no UI that runs while AYON is open, whatever the page: keeping a state, listening to
      * websocket events, registering a store listener. `component` loads at startup and is mounted
@@ -4102,7 +4065,7 @@ export declare const splitFiltersByScope: (combinedFilter: Record<string, any> |
 
 export declare const SplitterStyles: NamedExoticComponent< ExecutionProps & object>;
 
-export declare const StackedThumbnails: ({ thumbnails, isLoading, className, style, ...props }: StackedThumbnailsProps) => JSX_2.Element | null;
+export declare const StackedThumbnails: ({ thumbnails, isLoading, className, style, filmstrip, ...props }: StackedThumbnailsProps) => JSX_2.Element | null;
 
 export declare interface StackedThumbnailsProps extends Omit<ThumbnailProps, 'entityType' | 'entityId' | 'projectName' | 'thumbnailHash'> {
     thumbnails?: Thumbnail[];
@@ -4118,24 +4081,24 @@ declare type StagingDirectory = {
 
 declare type Status = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     state?: 'not_started' | 'in_progress' | 'done' | 'blocked';
     icon?: string;
     color?: string;
     /** Limit the status to specific entity types. */
-    scope?: string[];
+    scope?: string[] | null;
 };
 
 declare type Status_2 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     state?: 'not_started' | 'in_progress' | 'done' | 'blocked';
     icon?: string;
     color?: string;
     /** Limit the status to specific entity types. */
-    scope?: string[];
+    scope?: string[] | null;
 };
 
 declare type Status_3 = {
@@ -4414,76 +4377,32 @@ declare interface TabStateByScope {
 
 declare type Tag = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     color?: string;
 };
 
 declare type Tag_2 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     color?: string;
 };
 
-declare type TaskProgressSettings = {
-    filter?: QueryFilter_5;
-    sliceType?: string;
-    columns?: ColumnItemModel[];
-};
-
-declare type TaskProgressViewModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Determines whether the view is only available for the given project or for all projects (studio). */
-    scope: 'project' | 'studio';
-    /** Name of the user who created the view. Owners have full control over the view,  */
-    owner: string;
-    /** Visibility of the view. Public views are visible to all users, private views are only visible to the owner. */
-    visibility: 'public' | 'private';
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working: boolean;
-    position: number;
-    accessLevel: number;
-    settings: TaskProgressSettings;
-    access: object;
-    viewType?: 'taskProgress';
-};
-
-declare type TaskProgressViewPatchModel = {
-    label?: string;
-    owner?: string;
-    settings?: TaskProgressSettings;
-    viewType?: 'taskProgress';
-};
-
-declare type TaskProgressViewPostModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working?: boolean;
-    settings: TaskProgressSettings;
-    viewType?: 'taskProgress';
-};
-
 declare type TaskSuggestionItem = {
     /** The date and time when the suggested entity was created */
-    createdAt?: string;
+    createdAt?: string | null;
     /** The relevance score of the suggestion */
-    relevance?: number;
+    relevance?: number | null;
     id: string;
     taskType: string;
     name: string;
-    label?: string;
-    thumbnailId?: string;
-    parent?: FolderSuggestionItem;
+    label?: string | null;
+    thumbnailId?: string | null;
+    parent?: FolderSuggestionItem | null;
 };
 
 declare type TaskType = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -4491,7 +4410,7 @@ declare type TaskType = {
 
 declare type TaskType_2 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -4509,9 +4428,9 @@ export declare const TEAM_KEY_PREFIX = "team:";
 
 declare type TeamSuggestionItem = {
     /** The date and time when the suggested entity was created */
-    createdAt?: string;
+    createdAt?: string | null;
     /** The relevance score of the suggestion */
-    relevance?: number;
+    relevance?: number | null;
     name: string;
 };
 
@@ -4534,7 +4453,7 @@ declare type TextInputPt = Partial<React.ComponentProps<typeof Styled.InputText>
 
 declare type ThemeType = 'light' | 'dark';
 
-export declare const Thumbnail: ({ projectName, entityType, entityId, icon, color, thumbnailHash, isLoading, shimmer, className, disabled, src, hoverIcon, showBorder, ...props }: ThumbnailProps) => JSX_2.Element;
+export declare const Thumbnail: ({ projectName, entityType, entityId, icon, color, thumbnailHash, isLoading, shimmer, className, disabled, src, hoverIcon, showBorder, filmstrip, ...props }: ThumbnailProps) => JSX_2.Element;
 
 export declare interface ThumbnailProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {
     projectName?: string;
@@ -4550,6 +4469,8 @@ export declare interface ThumbnailProps extends Omit<HTMLAttributes<HTMLDivEleme
     src?: string;
     hoverIcon?: string;
     showBorder?: boolean;
+    /** show a hover-scrub filmstrip (the entity should have reviewables) */
+    filmstrip?: boolean;
 }
 
 export declare const ThumbnailSimple: default_2.FC<ThumbnailSimpleProps>;
@@ -4566,6 +4487,12 @@ export declare interface ThumbnailSimpleProps extends default_2.HTMLAttributes<H
     onLoad?: default_2.ReactEventHandler<HTMLImageElement>;
     onError?: default_2.ReactEventHandler<HTMLImageElement>;
     iconOnly?: boolean;
+    /** show a hover-scrub filmstrip (the entity should have reviewables) */
+    filmstrip?: boolean;
+    /** filmstrip url override, when the entity props are not available */
+    filmstripUrl?: string | null;
+    /** should match object-fit of the image */
+    filmstripFit?: 'cover' | 'contain';
 }
 
 /**
@@ -4587,6 +4514,8 @@ export declare type ToolbarLayout = (ToolbarItem | '|')[];
 
 declare type TopicUpdateType = 'created' | 'label_changed' | 'renamed' | 'type_changed' | 'status_changed' | 'tags_changed' | 'attrib_changed' | 'deleted';
 
+export declare const toUserRef: (user: UserDetailsSource) => UserRef;
+
 declare type UpdateEntitiesArgs = {
     operations: UpdateEntityOperation[];
     entityType: EntityType_2;
@@ -4617,8 +4546,8 @@ declare type UpdateSubtasksMutation = ReturnType<typeof useUpdateSubtasksMutatio
 declare type UpdateViewApiArg = {
     viewType: string;
     viewId: string;
-    projectName?: string;
-    payload: OverviewViewPatchModel | TaskProgressViewPatchModel | ListsViewPatchModel | ReviewsViewPatchModel | VersionsViewPatchModel | GenericViewPatchModel;
+    projectName?: string | null;
+    genericViewPatchModel: GenericViewPatchModel;
 };
 
 declare type UpdateViewSettingsFn = (updatedSettings: any, localStateSetter: (value: any) => void, newLocalValue: any, options: UpdateOptions) => Promise<void>;
@@ -4659,6 +4588,9 @@ export declare const useAddonTableShortcuts: (table: ShortcutTable | undefined)
     dialog: OpenAddonShortcutDialog | null;
 };
 
+/** The addons' items for the user details "more" menu. */
+export declare const useAddonUserMenuItems: (context: UserDetailsContext) => AddonUserMenuItems;
+
 export declare const useBuildFilterOptions: ({ filterTypes: globalFilterTypes, projectNames, scope, scopes: customScopes, data, config, power, }: BuildFilterOptions) => {
     options: Option_2[];
     groupOptions: SearchFilterGroupOption[];
@@ -4695,6 +4627,28 @@ export declare type UseDateRangeFilterReturn = {
     handleCustomRangeClose: () => void;
 };
 
+/**
+ * Adds a hover-scrub filmstrip to an ARC EntityCard.
+ *
+ * EntityCard does not accept thumbnail children, but it spreads `pt.thumbnail` onto its
+ * thumbnail element (ref included), so the filmstrip is portalled into that element.
+ *
+ * @example
+ * const { thumbnailProps, filmstrip } = useEntityCardFilmstrip(filmstripUrl)
+ * <EntityCard pt={{ thumbnail: thumbnailProps }} />
+ * {filmstrip}
+ */
+export declare const useEntityCardFilmstrip: (src?: string | null, { disabled }?: {
+    disabled?: boolean;
+}) => UseEntityCardFilmstripResult;
+
+declare interface UseEntityCardFilmstripResult {
+    /** pass to EntityCard `pt.thumbnail` */
+    thumbnailProps: Partial<HTMLAttributes<HTMLDivElement>>;
+    /** render next to the EntityCard */
+    filmstrip: ReactNode;
+}
+
 export declare const useFeedback: () => FeedbackContextType;
 
 export declare const useFeedbackSafe: () => FeedbackContextType | undefined;
@@ -4706,12 +4660,48 @@ export declare const useProjectPageSlotContext: (projectName: string) => SlotMap
 
 export declare const USER_KEY_PREFIX = "user:";
 
-declare type UserAttribModel = {
-    fullName?: string;
-    email?: string;
-    avatarUrl?: string;
-    developerMode?: boolean;
-};
+/** Context of a user details section or menu item. */
+declare interface UserDetailsContext extends UsersScope {
+    /**
+     * the signed-in user can't change these users (a manager and an admin among them): show,
+     * don't edit
+     */
+    readOnly: boolean
+}
+
+/** Description of a `userDetails.menuItem` contribution. */
+declare interface UserDetailsMenuItemMeta extends MenuItemMeta {
+    /** `single`: only when one user is selected; `multi` (default): for one or more */
+    selection?: UserSelection
+}
+
+/** Description of a `userDetails.section` contribution. */
+declare interface UserDetailsSectionMeta {
+    /** unique among the addon's sections */
+    id: string
+    /** the section's title, above its content */
+    title: string
+    /** order among addon sections, lowest first */
+    order?: number
+    /** `single`: only when one user is selected; `multi` (default): for one or more */
+    selection?: UserSelection
+    /** also shown for service users, whose panel has no forms; `false` by default */
+    serviceUsers?: boolean
+}
+
+/** A user as AYON's users queries have it. */
+export declare interface UserDetailsSource {
+    name: string;
+    active?: boolean;
+    isAdmin?: boolean;
+    isManager?: boolean;
+    isGuest?: boolean;
+    isService?: boolean;
+    attrib?: {
+        fullName?: string | null;
+        email?: string | null;
+    } | null;
+}
 
 export declare const useReviewablesUpload: ({ projectName, versionId, taskId, folderId, productId, dispatch, onUpload, onProgress, }: UseReviewablesUploadProps) => UploadHandlers;
 
@@ -4738,13 +4728,19 @@ declare interface UserImageProps {
 }
 
 declare type UserModel = {
-    /** Name is an unique id of the {entity_name} */
+    /** Unique name of the user */
     name: string;
-    uiExposureLevel?: number;
-    attrib?: UserAttribModel;
-    data?: Record<string, any>;
-    /** Whether the user is active */
+    uiExposureLevel?: number | null;
+    /** Attribute values of the entity */
+    attrib?: {
+        [key: string]: any;
+    };
+    data?: {
+        [key: string]: any;
+    };
+    /** Whether the entity is active */
     active?: boolean;
+    /** List of attributes explicitly set on the entity itself (not inherited) */
     ownAttrib?: string[];
     /** Time of creation */
     createdAt?: string;
@@ -4752,18 +4748,45 @@ declare type UserModel = {
     updatedAt?: string;
 };
 
+/**
+ * A user a slot is about, e.g. one selected in Settings → Users. Not the signed-in user: that is
+ * `user` in every slot.
+ */
+declare interface UserRef {
+    name: string
+    fullName?: string
+    email?: string
+    /** the account is active (not disabled) */
+    active: boolean
+    isAdmin: boolean
+    /** managers and admins */
+    isManager: boolean
+    isGuest: boolean
+    /** a service user (API key) */
+    isService: boolean
+}
+
 /** Every slot: the signed-in user. The host adds it; AYON renders addons only once signed in. */
 declare interface UserScope {
     user: AddonUser
 }
 
+/** Which selections a user details contribution shows for. */
+declare type UserSelection = 'single' | 'multi'
+
+/** Slots about one or more users. */
+declare interface UsersScope {
+    /** the users the slot is about, e.g. the ones selected in Settings → Users */
+    users: UserRef[]
+}
+
 declare type UserSuggestionItem = {
     /** The date and time when the suggested entity was created */
-    createdAt?: string;
+    createdAt?: string | null;
     /** The relevance score of the suggestion */
-    relevance?: number;
+    relevance?: number | null;
     name: string;
-    fullName?: string;
+    fullName?: string | null;
 };
 
 /** The context of a studio.page contribution. */
@@ -4951,10 +4974,13 @@ declare const useUpdateSubtasksMutation: <R extends Record<string, any> = ({
     reset: () => void;
 }];
 
+/** The context of the user details slots for the selected users. */
+export declare const useUserDetailsSlotContext: (users: UserDetailsSource[], readOnly: boolean) => UserDetailsContext;
+
 export declare const useVersionUploadContext: () => VersionUploadContextType;
 
 declare type UseViewMutations = {
-    onCreateView: (payload: CreateViewApiArg['payload'], isStudioScope: boolean) => Promise<void>;
+    onCreateView: (payload: GenericViewPostModel, isStudioScope: boolean) => Promise<void>;
     onDeleteView: (viewId: string, isStudioScope: boolean) => Promise<void>;
     onUpdateView: (viewId: string, payload: Partial<ViewData>, isStudioScope: boolean) => Promise<void>;
     onResetWorkingView: (args?: {
@@ -4966,70 +4992,15 @@ declare type UseViewMutations = {
     }) => Promise<string>;
 };
 
-declare type VersionsSettings = {
-    showProducts?: boolean;
-    rowHeight?: number;
-    showGrid?: boolean;
-    gridHeight?: number;
-    featuredVersionOrder?: string[];
-    slicerType?: string;
-    groupBy?: string;
-    groupSortByDesc?: boolean;
-    showEmptyGroups?: boolean;
-    latestPerFolder?: boolean;
-    sortBy?: string | string[];
-    sortDesc?: boolean;
-    filter?: QueryFilter_5;
-    columns?: ColumnItemModel[];
-};
-
 declare type VersionSuggestionItem = {
     /** The date and time when the suggested entity was created */
-    createdAt?: string;
+    createdAt?: string | null;
     /** The relevance score of the suggestion */
-    relevance?: number;
+    relevance?: number | null;
     id: string;
     version: number;
-    parent?: ProductSuggestionItem;
-    name?: string;
-};
-
-declare type VersionsViewModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Determines whether the view is only available for the given project or for all projects (studio). */
-    scope: 'project' | 'studio';
-    /** Name of the user who created the view. Owners have full control over the view,  */
-    owner: string;
-    /** Visibility of the view. Public views are visible to all users, private views are only visible to the owner. */
-    visibility: 'public' | 'private';
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working: boolean;
-    position: number;
-    accessLevel: number;
-    settings: VersionsSettings;
-    access: object;
-    viewType?: 'versions';
-};
-
-declare type VersionsViewPatchModel = {
-    label?: string;
-    owner?: string;
-    settings?: VersionsSettings;
-    viewType?: 'versions';
-};
-
-declare type VersionsViewPostModel = {
-    /** Unique identifier for the view within the given scope. */
-    id?: string;
-    /** Human-readable name of the view. */
-    label: string;
-    /** Working view is a special type of the view that automatically stores the current view settings without explicitly saving them. Working views are always private and scoped to the project  */
-    working?: boolean;
-    settings: VersionsSettings;
-    viewType?: 'versions';
+    parent?: ProductSuggestionItem | null;
+    name?: string | null;
 };
 
 export declare const VersionUploadContext: Context<VersionUploadContextType | undefined>;
@@ -5205,15 +5176,15 @@ declare const viewsQueries: Api<BaseQueryFn<string | {
     getWorkingView: QueryDefinition<GetWorkingViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetWorkingViewApiResponse, "restApi", unknown>;
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
     getBaseView: QueryDefinition<GetBaseViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetBaseViewApiResponse, "restApi", unknown>;
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
     getDefaultView: QueryDefinition<GetDefaultViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetDefaultViewApiResponse, "restApi", unknown>;
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
     setDefaultView: MutationDefinition<SetDefaultViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
@@ -5221,12 +5192,12 @@ declare const viewsQueries: Api<BaseQueryFn<string | {
     getView: QueryDefinition<GetViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetViewApiResponse, "restApi", unknown>;
-    deleteView: MutationDefinition<DeleteViewApiArg, BaseQueryFn<string | {
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
+    updateView: MutationDefinition<UpdateViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
     } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, any, "restApi", unknown>;
-    updateView: MutationDefinition<UpdateViewApiArg, BaseQueryFn<string | {
+    deleteView: MutationDefinition<DeleteViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
     } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, any, "restApi", unknown>;
@@ -5242,15 +5213,15 @@ declare const viewsQueries: Api<BaseQueryFn<string | {
     getWorkingView: QueryDefinition<GetWorkingViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetWorkingViewApiResponse, "restApi", unknown>;
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
     getBaseView: QueryDefinition<GetBaseViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetBaseViewApiResponse, "restApi", unknown>;
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
     getDefaultView: QueryDefinition<GetDefaultViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetDefaultViewApiResponse, "restApi", unknown>;
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
     setDefaultView: MutationDefinition<SetDefaultViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
@@ -5258,12 +5229,12 @@ declare const viewsQueries: Api<BaseQueryFn<string | {
     getView: QueryDefinition<GetViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
-    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GetViewApiResponse, "restApi", unknown>;
-    deleteView: MutationDefinition<DeleteViewApiArg, BaseQueryFn<string | {
+    } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, GenericViewModel, "restApi", unknown>;
+    updateView: MutationDefinition<UpdateViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
     } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, any, "restApi", unknown>;
-    updateView: MutationDefinition<UpdateViewApiArg, BaseQueryFn<string | {
+    deleteView: MutationDefinition<DeleteViewApiArg, BaseQueryFn<string | {
         document: string | DocumentNode;
         variables?: any;
     } | FetchArgs, unknown, FetchBaseQueryError, {} | Partial<Pick< ClientError, "response" | "request">>>, string, any, "restApi", unknown>;