@ynput/ayon-frontend-shared 0.7.5 → 0.8.0

package/dist/types/ProjectTreeTable.d.ts

@@ -105,8 +105,6 @@ export declare type ActivityOperationsResponseModel = {
     success: boolean;
 };
 
-export declare const ADDON_COLUMN_PREFIX = "addon__";
-
 /**
  * Gets the values of every shown addon column for the rows on screen (fetchValues), into the
  * store the cells read. Wraps the table body.
@@ -171,6 +169,22 @@ declare type AddonMenuItem =
     danger?: boolean
 }
 
+/** The signed-in user, as addons see it: in every slot's context (`user`) and from `useUser`. */
+declare interface AddonUser {
+    name: string
+    fullName?: string
+    email?: string
+    /** admins, and service users (the server treats them as admins) */
+    isAdmin: boolean
+    /** managers and admins */
+    isManager: boolean
+    isGuest: boolean
+    /** a service user: an API key session (services, agents, CI) */
+    isService: boolean
+    /** developer mode is on */
+    isDeveloper: boolean
+}
+
 export declare const allowedGroupByFields: string[];
 
 export declare const ALWAYS_VISIBLE_COLUMNS: string[];
@@ -183,7 +197,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 */
@@ -205,7 +221,9 @@ declare type Anatomy_2 = {
     /** Path templates configuration */
     templates?: Templates_2;
     /** Attributes configuration */
-    attributes?: ProjectAttribModel_2;
+    attributes?: {
+        [key: string]: any;
+    };
     /** Folder types configuration */
     folder_types?: FolderType_4[];
     /** Task types configuration */
@@ -223,76 +241,96 @@ export declare const appliesToPage: (contribution: {
     pages?: ProjectTablePage[];
 }, page: ProjectTablePage) => boolean;
 
+/** Context of a service. */
+declare interface AppServiceContext {
+    /** the project whose page is open, else `null` */
+    projectName: string | null
+}
+
+/** Description of an `app.service` contribution. */
+declare interface AppServiceMeta {
+    /** unique among the addon's services */
+    id: string
+}
+
 declare type AttributeData = {
     /** 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 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_3[];
+    enum?: EnumItem_3[] | 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 interface AttributeField {
@@ -326,6 +364,8 @@ export declare interface BaseEntityData {
     tags?: string[];
     createdAt?: string;
     updatedAt?: string;
+    createdBy?: string | null;
+    updatedBy?: string | null;
     thumbnailHash?: string;
     attrib?: Record<string, any>;
     ownAttrib?: string[];
@@ -425,8 +465,20 @@ declare interface ButtonPieces<S extends SlotName> {
     dialog?: Loader<ComponentType<SlotProps<S> & DialogScope>>
     /** the items of a menu the host opens under the button, like the header's help menu */
     menu?: Loader<MenuPiece<S>>
-    /** the addon's own component instead of the host's button: a dropdown, a toggle, anything */
-    component?: Loader<ComponentType<SlotProps<S>>>
+    /**
+     * the content of a popover the host opens under the button, like the header's menus: the host
+     * positions it and closes it on a click outside or Escape (an Escape or click inside a menu or
+     * dialog opened from the popover closes only that). It gets `close`
+     */
+    popover?: Loader<ComponentType<SlotProps<S> & PopoverScope>>
+    /**
+     * the addon's own component instead of the host's button: a dropdown, a toggle, anything. With
+     * `popover`, it is the popover's button (its icon, a badge, a tooltip of its own) and gets
+     * `popoverOpen` and `togglePopover`
+     */
+    component?:
+    | Loader<ComponentType<SlotProps<S>>>
+    | Loader<ComponentType<SlotProps<S> & PopoverButtonScope>>
 }
 
 /** Context of a button's code (`run`, `dialog`, `menu`, `component`) besides the slot's own. */
@@ -796,7 +848,7 @@ export declare const DEFAULT_ROW_SCOPE: RowScope;
 
 export declare const DEFAULT_SUMMARY_FORMAT: SummaryFormat;
 
-export declare type DefaultColumns = typeof ROW_SELECTION_COLUMN_ID | 'thumbnail' | 'name' | 'entityType' | typeof ENTITY_COLUMN_IDS.folder | 'status' | 'subType' | 'assignees' | 'tags' | 'createdAt' | 'updatedAt' | 'comments' | typeof LISTS_COLUMN_ID | typeof REVIEW_SESSIONS_COLUMN_ID;
+export declare type DefaultColumns = typeof ROW_SELECTION_COLUMN_ID | 'thumbnail' | 'name' | 'entityType' | typeof ENTITY_COLUMN_IDS.folder | 'status' | 'subType' | 'assignees' | 'tags' | 'createdAt' | 'createdBy' | 'updatedAt' | 'updatedBy' | 'comments' | typeof LISTS_COLUMN_ID | typeof REVIEW_SESSIONS_COLUMN_ID;
 
 declare type DefaultMenuItem = 'copy-paste' | 'show-details' | 'rename' | 'expand-collapse' | 'inherit' | 'delete' | 'export' | 'create-folder' | 'create-task' | 'open-viewer';
 
@@ -842,11 +894,7 @@ export declare interface DetailsPanelEntityProviderProps {
 }
 
 /** Context of a details panel menu item. */
-declare interface DetailsPanelMenuItemContext extends ProjectNameScope {
-    entityType: string
-    /** the entities the panel shows */
-    selectedEntities: EntityRef[]
-}
+declare interface DetailsPanelMenuItemContext extends ProjectNameScope, EntityScope_2 {}
 
 /** Description of a `detailsPanel.menuItem` contribution. */
 declare interface DetailsPanelMenuItemMeta extends MenuItemMeta {
@@ -937,6 +985,8 @@ declare interface EditorCellProps extends Omit<React.HTMLAttributes<HTMLDivEleme
 }
 
 export declare type EditorProductNode = {
+    createdBy?: string | null;
+    updatedBy?: string | null;
     id: string;
     entityId: string;
     entityType: 'product';
@@ -957,7 +1007,9 @@ export declare type EditorProductNode = {
     hasVersions?: boolean;
 };
 
-export declare type EditorTaskNode = Omit<TaskNode, 'links' | 'data'> & {
+export declare type EditorTaskNode = Omit<TaskNode, 'links' | 'data' | 'createdBy' | 'updatedBy'> & {
+    createdBy?: string | null;
+    updatedBy?: string | null;
     attrib: Record<string, any>;
     entityId: string;
     entityType: 'task';
@@ -971,6 +1023,8 @@ export declare type EditorTaskNode = Omit<TaskNode, 'links' | 'data'> & {
 };
 
 export declare type EditorVersionNode = {
+    createdBy?: string | null;
+    updatedBy?: string | null;
     id: string;
     entityId: string;
     entityType: 'version';
@@ -1150,7 +1204,9 @@ export declare type EntityScope = 'primary' | EntityType;
 
 /** Slots about one or more entities of one type. */
 declare interface EntityScope_2 {
+    /** the type of every entity in `entities` */
     entityType: string
+    /** the entities the slot is about, e.g. the ones the details panel shows */
     entities: EntityRef[]
 }
 
@@ -1190,46 +1246,61 @@ export declare const EnumCellValue: ({ selectedOptions, placeholder, hasMultiple
 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 type EnumItem_2 = {
     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_2;
-    color?: string;
-    shortName?: string;
+    icon?: string | IconModel_2 | 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;
+    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 type EnumItem_3 = {
     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_3;
-    color?: string;
+    icon?: string | IconModel_3 | 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 | null;
+    /** Enum item is not visible in the dropdown */
+    hidden?: boolean;
+    /** Extra badge labels to display next to the item */
+    badges?: string[] | null;
 };
 
 declare interface EnumOption extends EnumItem {
@@ -1421,6 +1492,8 @@ export declare type FolderListItem = {
     ownAttrib?: string[];
     updatedAt: string;
     createdAt: string;
+    createdBy?: string | null;
+    updatedBy?: string | null;
     thumbnailHash?: string;
     hasReviewables?: boolean;
     hasVersions?: boolean;
@@ -1430,22 +1503,28 @@ export declare type FolderListItem = {
 declare type FolderListItem_2 = {
     id: string;
     path: string;
-    parentId?: string;
+    parentId?: string | null;
     parents: string[];
     name: string;
-    label?: string;
+    label?: string | null;
     folderType: string;
     hasTasks?: boolean;
     hasChildren?: boolean;
     hasReviewables?: boolean;
     thumbnailHash: string;
-    taskNames?: string[];
-    tags?: string[];
+    taskNames?: string[] | null;
+    tags?: string[] | null;
     status: string;
-    attrib?: object;
-    ownAttrib?: string[];
+    attrib?: {
+        [key: string]: any;
+    } | null;
+    active?: boolean;
+    visible?: boolean;
+    ownAttrib?: string[] | null;
     createdAt: string;
     updatedAt: string;
+    createdBy?: string | null;
+    updatedBy?: string | null;
 };
 
 declare type FolderListModel = {
@@ -1457,7 +1536,7 @@ export declare type FolderNodeMap = Map<string, MatchingFolder>;
 
 declare type FolderType = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -1465,7 +1544,7 @@ declare type FolderType = {
 
 declare type FolderType_2 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -1481,7 +1560,7 @@ declare type FolderType_3 = {
 
 declare type FolderType_4 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -1489,7 +1568,7 @@ declare type FolderType_4 = {
 
 declare type FolderType_5 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -1789,6 +1868,8 @@ declare type GetTasksByParentQuery = {
                     taskType: string;
                     updatedAt: unknown;
                     createdAt: unknown;
+                    createdBy: string | null;
+                    updatedBy: string | null;
                     thumbnailHash: string;
                     active: boolean;
                     assignees: Array<string>;
@@ -2134,31 +2215,31 @@ declare type IconAnatomy = Pick<Anatomy_2, 'folder_types' | 'task_types' | 'prod
 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 type IconModel_3 = {
     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 interface InheritedDependent {
@@ -2269,7 +2350,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';
 };
 
@@ -2277,7 +2358,7 @@ declare type LinkType_2 = {
     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';
 };
 
@@ -2291,7 +2372,9 @@ declare type LinkTypeModel = {
     /** Output entity type */
     outputType: string;
     /** Additional link type data */
-    data?: Record<string, any>;
+    data?: {
+        [key: string]: any;
+    };
 };
 
 declare type LinkTypeModel_2 = {
@@ -2304,7 +2387,9 @@ declare type LinkTypeModel_2 = {
     /** Output entity type */
     outputType: string;
     /** Additional link type data */
-    data?: object;
+    data?: {
+        [key: string]: any;
+    };
 };
 
 export declare type LinkValue = LinkEntity[];
@@ -2399,6 +2484,8 @@ export declare interface MarkdownWidgetProps extends WidgetBaseProps {
 }
 
 export declare type MatchingFolder = FolderListItem & {
+    createdBy?: string | null;
+    updatedBy?: string | null;
     childOnlyMatch?: boolean;
     entityId: string;
     entityType: 'folder';
@@ -2489,10 +2576,12 @@ declare type OperationModel_2 = {
     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;
+    asUser?: string | null;
 };
 
 export declare type OperationResponseModel = {
@@ -2679,6 +2768,23 @@ export declare type PatchOperation = Pick<OperationModel, 'entityId' | 'entityTy
     type?: OperationModel['type'];
 };
 
+/**
+ * What a `component` gets besides the slot context when it draws the button of a `popover`. The
+ * host anchors the popover on the component's box.
+ */
+declare interface PopoverButtonScope {
+    /** the popover is open: show the button as active (`aria-expanded`) */
+    popoverOpen: boolean
+    /** opens or closes the popover: the button's `onClick` */
+    togglePopover: () => void
+}
+
+/** What a `popover` piece gets besides the slot context. */
+declare interface PopoverScope {
+    /** closes the popover */
+    close: () => void
+}
+
 declare type PowerpackContextType = {
     selectedPowerPack: PowerpackFeature | null;
     selectedAddon: AddonDialogSelection | null;
@@ -2757,78 +2863,9 @@ declare type ProductType_2 = {
 
 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;
-};
-
-declare type ProjectAttribModel_2 = {
-    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 {
@@ -2889,6 +2926,7 @@ declare interface ProjectFolders {
 }
 
 declare interface ProjectFoldersContextValue {
+    projectName: string;
     folders: FolderListItem_2[];
     getFolderById: (id: string) => FolderListItem_2 | undefined;
     findNonInheritedValues: (folderId: string | undefined, attribNames: string[], projectAttrib?: Record<string, any>) => Record<string, any>;
@@ -2943,22 +2981,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;
@@ -3041,6 +3087,15 @@ export declare interface ProjectOverviewProviderProps {
     modules: ProjectTableModulesType;
 }
 
+/** 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
+}
+
 /** Slots that are about one project, with the project itself. */
 declare interface ProjectScope extends ProjectNameScope {
     /** the project; `undefined` while it loads */
@@ -3200,6 +3255,8 @@ export declare interface ProjectTableProviderProps {
         versionId?: string;
     }, config?: {
         quickView?: boolean;
+        goToPosition?: number;
+        reviewableId?: string;
     }) => void;
     onResetView?: () => void;
     hiddenListIds?: string[];
@@ -3330,9 +3387,9 @@ declare type QueryCondition_3 = {
     /** 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';
 };
 
 export declare type QueryFilter = {
@@ -3611,6 +3668,8 @@ declare interface SlicerMenuItemContext extends ProjectNameScope {
     sliceType: string
     /** the rows it acts on: the selected ones, or the right-clicked one */
     selected: SlicerRowRef[]
+    /** `hierarchy`: the folders and tasks of `selected`; empty for the other slice types */
+    entities: EntityRef[]
     menu: MenuKind
 }
 
@@ -3647,9 +3706,12 @@ declare interface SlicerSelection {
     selection: string[]
 }
 
-/** What the code of a contribution to slot `S` gets: `{ slot: S, ...context }`. */
+/**
+ * What the code of a contribution to slot `S` gets: `{ slot: S, user, ...context }`. The host
+ * passes the slot's own context; `ContributionView` and `runContribution` add `slot` and `user`.
+ */
 declare type SlotContext<S extends SlotName> = S extends SlotName
-? { slot: S } & SlotMap[S]['context']
+? { slot: S } & UserScope & SlotMap[S]['context']
 : never
 
 /**
@@ -3664,7 +3726,7 @@ declare interface SlotMap {
      */
     'project.page': {
         version: 1
-        meta: PageMeta
+        meta: ProjectPageMeta
         context: ProjectScope & SlicerScope & ProjectFoldersScope & ViewsScope
         pieces: { component: Loader<ComponentType<SlotProps<'project.page'>>> }
     }
@@ -3680,8 +3742,9 @@ declare interface SlotMap {
     }
     /**
      * A button in the main header, drawn by the host like its own buttons. What a click does is the
-     * addon's: navigate (`to`), run code (`run`), open a dialog (`dialog`) or a menu (`menu`); or the
-     * addon draws the item itself (`component`, loaded with the header). Set exactly one.
+     * addon's: navigate (`to`), run code (`run`), open a dialog (`dialog`), a menu (`menu`) or a
+     * popover (`popover`); or the addon draws the item itself (`component`, loaded with the header).
+     * Set exactly one, except that `component` may draw the button of a `popover`.
      */
     'header.item': {
         version: 1
@@ -3742,8 +3805,9 @@ declare interface SlotMap {
     /**
      * A button in the project tables' toolbar, before Customize (Overview, Products, Lists), drawn
      * by the host like the toolbar's own. What a click does is the addon's: navigate (`to`), run code
-     * (`run`), open a dialog (`dialog`) or a menu (`menu`); or the addon draws the item itself
-     * (`component`, loaded with the toolbar). Set exactly one.
+     * (`run`), open a dialog (`dialog`), a menu (`menu`) or a popover (`popover`); or the addon draws
+     * the item itself (`component`, loaded with the toolbar). Set exactly one, except that
+     * `component` may draw the button of a `popover`.
      */
     'projectTable.toolbarItem': {
         version: 1
@@ -3766,7 +3830,9 @@ declare interface SlotMap {
      * settings from the description; `cell` and `fetchValues` load with the table. The host draws
      * the cell box (padding, selection, focus), so `cell` renders only its content; selecting, the
      * right-click menu and Copy (the cell's `value` as text) work as in other columns. Not sortable,
-     * and pasting into it changes nothing.
+     * and pasting into it changes nothing. When the values depend on data your mutations change, list
+     * its cache tags in `providesTags` and the column refreshes itself when they are invalidated:
+     * `tableColumn({ id, label, cell, fetchValues, providesTags: [{ type: 'myaddonLog', id: 'LIST' }] })`.
      */
     tableColumn: {
         version: 1
@@ -3790,6 +3856,19 @@ declare interface SlotMap {
         context: TableShortcutContext
         pieces: TableShortcutPieces
     }
+    /**
+     * 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
+     * once for the whole app, under AYON's providers (store, router, contexts), so it can use hooks;
+     * it renders nothing (`return null`). Clean up in its effects. A crash unmounts it and shows a
+     * toast; the rest of AYON keeps working.
+     */
+    'app.service': {
+        version: 1
+        meta: AppServiceMeta
+        context: AppServiceContext
+        pieces: { component: Loader<ComponentType<SlotProps<'app.service'>>> }
+    }
 }
 
 /** The name of a slot, e.g. `'project.page'`. */
@@ -3830,24 +3909,24 @@ declare type StagingDirectory_2 = {
 
 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 = {
@@ -3863,24 +3942,24 @@ declare type Status_3 = {
 
 declare type Status_4 = {
     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_5 = {
     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;
 };
 
 /** Context of a studio page. */
@@ -3977,6 +4056,8 @@ export declare type SummaryFormat = 'count' | 'percent' | 'both' | 'none';
 
 export declare type SummaryKind = 'main' | 'number' | 'boolean' | 'text' | 'enum' | 'assignee' | 'blank';
 
+export declare const SYSTEM_READ_ONLY_COLUMNS: string[];
+
 export declare const TABLE_CONTAINER_ATTR = "data-column-dnd-container";
 
 export declare const TableCellContext: Context<TableCellContextValue>;
@@ -4013,7 +4094,8 @@ export declare type TableCellContextValue = {
  * Gets a column's values, by entity id; each cell gets its own as `value`. AYON calls it with
  * the rows that come on screen and that it has no value for yet, in batches once scrolling
  * pauses, and keeps what it returns: scrolling back costs nothing. A row whose entity changes
- * (here or by someone else) is asked for again; `refreshTableColumn(id)` asks again for all.
+ * (here or by someone else) is asked for again; for anything else the values depend on, list its
+ * cache tags in the column's `providesTags`, or call `refreshTableColumn(id)` to ask again for all.
  * When it throws, those cells show the error and are tried again when they next come on
  * screen. Fetch through AYON's store (`dispatch(api.endpoints.x.initiate(...))`) to share its
  * cache.
@@ -4048,8 +4130,23 @@ declare interface TableColumnMeta {
      * `false` for the menu's top level
      */
     menu?: string | false
+    /**
+     * cache tags of AYON's api that the values depend on: when one is invalidated (by your
+     * mutations or AYON's), the values are fetched again as with `refreshTableColumn`. Needs
+     * `fetchValues`. Names as you register them (`enhanceEndpoints({ addTagTypes })`, prefixed with
+     * your addon name) or AYON's own. A plain name follows invalidations of the whole type only: to
+     * follow `{ type, id }`, such as a list tag, give that tag
+     */
+    providesTags?: TableColumnTag[]
 }
 
+/**
+ * A cache tag a `tableColumn` depends on (`providesTags`), as in RTK Query: a tag type, or a type
+ * and id. Invalidating `'x'` refreshes columns that list `'x'` or `{ type: 'x', id }`;
+ * invalidating `{ type: 'x', id: 'LIST' }` refreshes only columns that list that tag.
+ */
+declare type TableColumnTag = string | { type: string; id?: string | number }
+
 export declare interface TableGroupBy {
     desc: boolean;
     id: string;
@@ -4103,6 +4200,11 @@ declare interface TableShortcutContext {
     projectName: string | null
     /** the rows it acts on: the selected ones when the key was pressed in one of them, else its row */
     rows: TableRowRef[]
+    /**
+     * the entities of `rows` in the project tables (list items resolve to their entity); empty in
+     * the panels' tables, whose rows are not all entities: read `rows` there
+     */
+    entities: EntityRef[]
     /** where the key was pressed: the row's id, and the column's in the project tables */
     focused: { rowId: string; columnId?: string }
     /** project tables: the selected cells, by row (entity) and column id; empty elsewhere */
@@ -4148,13 +4250,13 @@ export declare type TableUser = {
 
 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;
 };
 
@@ -4166,13 +4268,13 @@ declare type Tag_3 = {
 
 declare type Tag_4 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     color?: string;
 };
 
 declare type Tag_5 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     color?: string;
 };
 
@@ -4208,9 +4310,9 @@ export declare type TasksByFolderMap = Map<string, string[]>;
 
 declare type TasksFoldersQuery = {
     /** Filter object used to resolve the tasks */
-    filter?: QueryFilter_3;
+    filter?: QueryFilter_3 | null;
     /** 'fulltext' search used to resolve the tasks */
-    search?: string;
+    search?: string | null;
 };
 
 export declare type TaskStatsArgs = {
@@ -4224,7 +4326,7 @@ export declare type TaskStatsArgs = {
 
 declare type TaskType = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -4232,7 +4334,7 @@ declare type TaskType = {
 
 declare type TaskType_2 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -4248,7 +4350,7 @@ declare type TaskType_3 = {
 
 declare type TaskType_4 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -4256,7 +4358,7 @@ declare type TaskType_4 = {
 
 declare type TaskType_5 = {
     name: string;
-    original_name?: string;
+    original_name?: string | null;
     shortName?: string;
     color?: string;
     icon?: string;
@@ -4575,21 +4677,20 @@ declare type User = {
     hidden?: boolean;
 };
 
-declare type UserAttribModel = {
-    fullName?: string;
-    email?: string;
-    avatarUrl?: string;
-    developerMode?: boolean;
-};
-
 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;
@@ -4597,6 +4698,11 @@ declare type UserModel = {
     updatedAt?: string;
 };
 
+/** Every slot: the signed-in user. The host adds it; AYON renders addons only once signed in. */
+declare interface UserScope {
+    user: AddonUser
+}
+
 export declare const useScopedAttributeFields: <T extends AttributeField>({ attribFields, allowedScopes, }: UseScopedAttributeFieldsProps<T>) => T[];
 
 declare interface UseScopedAttributeFieldsProps<T extends AttributeField> {