@minecraft/server-editor 0.1.0-beta.1.21.120-preview.25 → 0.1.0-beta.1.21.130-preview.22

package/index.d.ts

@@ -178,6 +178,10 @@ export declare enum CoreMenuType {
     WorldOptions = 'editor:menu:worldOptions',
 }
 
+export declare enum CoreModalDialogType {
+    DataPicker = 0,
+}
+
 /**
  * An enumeration used by the 3D block cursor {@link Cursor}
  */
@@ -244,6 +248,10 @@ export enum CursorTargetMode {
     Face = 1,
 }
 
+export declare enum DataPickerModalDialogVariant {
+    Block = 0,
+}
+
 export enum DaylightCycle {
     Normal = 0,
     AlwaysDay = 1,
@@ -955,6 +963,22 @@ export declare enum LayoutDirection {
     Horizontal = 1,
 }
 
+export declare enum ListPaneEntryType {
+    Button = 0,
+    Bool = 1,
+    Image = 2,
+    Text = 3,
+}
+
+/**
+ * Determines how list pane slots will be sorted
+ */
+export declare enum ListPaneViewSortType {
+    Default = 0,
+    AtoZ = 1,
+    ZtoA = 2,
+}
+
 export enum LogChannel {
     /**
      * @remarks
@@ -976,6 +1000,20 @@ export enum LogChannel {
     All = 3,
 }
 
+/**
+ * Common response types for modal dialog
+ */
+export declare enum ModalDialogResponseType {
+    Confirm = 'confirm',
+    Dismiss = 'dismiss',
+    Error = 'error',
+}
+
+export declare enum ModalDialogType {
+    DataPicker = 0,
+    Custom = 1,
+}
+
 /**
  * Mouse device action categories
  */
@@ -1106,6 +1144,7 @@ export declare enum PropertyItemType {
     Dropdown = 'editorUI:Dropdown',
     Image = 'editorUI:Image',
     Link = 'editorUI:Link',
+    ListPane = 'editorUI:ListPane',
     Menu = 'editorUI:Menu',
     Number = 'editorUI:Number',
     NumberTimeline = 'editorUI:NumberTimeline',
@@ -1380,6 +1419,7 @@ export type IPlayerUISession<PerPlayerStorage = Record<string, never>> = {
     readonly menuBar: IMenuContainer;
     readonly actionBar: IActionBar;
     readonly statusBar: IStatusBar;
+    readonly dialogManager: IModalDialogManager;
     readonly toolRail: IModalToolContainer;
     readonly log: IPlayerLogger;
     readonly extensionContext: ExtensionContext;
@@ -1405,6 +1445,108 @@ export type KeyBindingInfo = {
     tooltip?: string;
 };
 
+/**
+ * Layout size definition
+ */
+export declare type LayoutSize = {
+    value: number;
+    type?: 'default' | 'percentage';
+};
+
+/**
+ * List Pane Bool entry creation parameter
+ */
+export type ListPaneBoolEntryParams = {
+    type: ListPaneEntryType.Bool;
+    value: IObservableProp<boolean>;
+    tooltip?: BasicTooltipContent;
+    icon?: string;
+    enabled?: boolean;
+    visible?: boolean;
+    onChange?: (newValue: boolean, oldValue: boolean, entry: IListPaneBoolEntry) => void;
+};
+
+/**
+ * List Pane Button entry creation parameter
+ */
+export type ListPaneButtonEntryParams = {
+    type: ListPaneEntryType.Button;
+    onClick: (entry: IListPaneButtonEntry) => void;
+    title?: LocalizedString;
+    tooltip?: BasicTooltipContent;
+    variant?: ButtonPropertyItemVariant;
+    icon?: string;
+    enabled?: boolean;
+    visible?: boolean;
+};
+
+/**
+ * List Pane entry type map
+ */
+export type ListPaneEntryMap = {
+    [ListPaneEntryType.Button]: IListPaneEntry;
+    [ListPaneEntryType.Bool]: IListPaneBoolEntry;
+    [ListPaneEntryType.Image]: IListPaneImageEntry;
+    [ListPaneEntryType.Text]: IListPaneTextEntry;
+};
+
+/**
+ * List Pane entry creation parameters
+ */
+export type ListPaneEntryParams =
+    | ListPaneButtonEntryParams
+    | ListPaneBoolEntryParams
+    | ListPaneTextEntryParams
+    | ListPaneImageEntryParams;
+
+/**
+ * List Pane Image entry creation parameter
+ */
+export type ListPaneImageEntryParams = {
+    type: ListPaneEntryType.Image;
+    value: IObservableProp<ImageResourceData>;
+    visible?: boolean;
+};
+
+/**
+ * Properties required to create a slot
+ */
+export type ListPaneSlotCreationProps = {
+    entries: ListPaneEntryParams[];
+    options?: IListPaneSlotOptions;
+};
+
+export declare type ListPaneSlotLayout = {
+    height: number;
+    columns?: number;
+    clickable?: boolean;
+    outline?: boolean;
+    entryLayout: ListPaneSlotLayoutEntry[];
+};
+
+export declare type ListPaneSlotLayoutEntry = {
+    type: ListPaneEntryType;
+    size?: number | LayoutSize | 'shrink' | 'grow';
+    alignment?: LayoutAlignment;
+};
+
+/**
+ * List Pane Text entry creation parameter
+ */
+export type ListPaneTextEntryParams = {
+    type: ListPaneEntryType.Text;
+    value?: IObservableProp<LocalizedString>;
+    visible?: boolean;
+};
+
+/**
+ * Determines filtering properties for list pane
+ */
+export declare type ListPaneViewFilter = {
+    slots?: string[];
+    tags?: string[];
+};
+
 /**
  * Represents a localized string or an object with a localized
  * string and optional properties
@@ -1416,6 +1558,61 @@ export declare type LocalizedString =
           props?: string[];
       };
 
+/**
+ * Parameters required to activate a modal dialog instance
+ */
+export type ModalDialogActivationParams<T extends CoreModalDialogType | string> = {
+    dialogId: T;
+    onResponse?: (
+        payload:
+            | (T extends CoreModalDialogType ? ModalDialogCoreResponseType[T] : ModalDialogCustomResponse)
+            | ModalDialogDismissResponse,
+    ) => void;
+} & (T extends CoreModalDialogType
+    ? {
+          data: ModalDialogRequestData[T];
+      }
+    : {
+          data?: never;
+      });
+
+/**
+ * Response data for core modal dialogs
+ */
+export type ModalDialogCoreResponseType = {
+    [CoreModalDialogType.DataPicker]: ModalDialogDataPickerResponse;
+};
+
+/**
+ * Response data for custom modal dialog
+ */
+export type ModalDialogCustomResponse = {
+    type: ModalDialogResponseType | string;
+    payload?: unknown;
+};
+
+/**
+ * Payloads that confirm data picker selection
+ */
+export type ModalDialogDataPickerResponse = {
+    type: ModalDialogResponseType.Confirm;
+    selected: string;
+};
+
+export type ModalDialogDismissResponse = {
+    type: ModalDialogResponseType.Dismiss;
+};
+
+/**
+ * Data types supported by a modal dialog request
+ */
+export type ModalDialogRequestData = {
+    [CoreModalDialogType.DataPicker]: {
+        default: string;
+        variant: DataPickerModalDialogVariant;
+    };
+};
+
 /**
  * Modal tool lifecycle event payload
  */
@@ -6134,6 +6331,444 @@ export interface ILinkPropertyItemOptions extends IPropertyItemOptionsBase {
     tooltip?: LocalizedString;
 }
 
+/**
+ * List Pane button entry
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IListPaneBoolEntry extends IListPaneEntry {
+    /**
+     * @remarks
+     * Enabled state of the entry.
+     *
+     */
+    readonly enabled: boolean;
+    /**
+     * @remarks
+     * Value of the entry.
+     *
+     */
+    readonly value: boolean;
+    /**
+     * @remarks
+     * Updates enabled state of the entry.
+     *
+     * @param enabled
+     * New enabled state.
+     */
+    setEnabled(enabled: true): void;
+    /**
+     * @remarks
+     * Updates tooltip of the entry.
+     *
+     * @param tooltip
+     * New tooltip.
+     */
+    setTooltip(tooltip: BasicTooltipContent): void;
+    /**
+     * @remarks
+     * Updates value of the entry.
+     *
+     * @param value
+     * New value.
+     */
+    setValue(value: boolean): void;
+}
+
+/**
+ * List Pane button entry
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IListPaneButtonEntry extends IListPaneEntry {
+    /**
+     * @remarks
+     * Enabled state of the entry.
+     *
+     */
+    readonly enabled: boolean;
+    /**
+     * @remarks
+     * Updates enabled state of the entry.
+     *
+     * @param enabled
+     * New enabled state.
+     */
+    setEnabled(enabled: true): void;
+    /**
+     * @remarks
+     * Updates icon of the entry.
+     *
+     * @param icon
+     * New icon.
+     */
+    setIcon(icon: string): void;
+    /**
+     * @remarks
+     * Updates title of the entry.
+     *
+     * @param title
+     * New title.
+     */
+    setTitle(title: string): void;
+    /**
+     * @remarks
+     * Updates tooltip of the entry.
+     *
+     * @param tooltip
+     * New tooltip.
+     */
+    setTooltip(tooltip: BasicTooltipContent): void;
+}
+
+/**
+ * List Pane entry
+ */
+export interface IListPaneEntry {
+    /**
+     * @remarks
+     * Sequence index of the entry.
+     *
+     */
+    readonly index: number;
+    /**
+     * @remarks
+     * Slot that owns the entry.
+     *
+     */
+    readonly slot: IListPaneSlot;
+    /**
+     * @remarks
+     * Type of the entry.
+     *
+     */
+    readonly type: ListPaneEntryType;
+    /**
+     * @remarks
+     * Visibility state of the entry.
+     *
+     */
+    readonly visible: boolean;
+    /**
+     * @remarks
+     * Updates visibility of the entry.
+     *
+     * @param visible
+     * New value.
+     */
+    setVisible(visible: boolean): void;
+}
+
+/**
+ * List Pane image entry
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IListPaneImageEntry extends IListPaneEntry {
+    /**
+     * @remarks
+     * Value of the entry.
+     *
+     */
+    readonly value: Readonly<ImageResourceData>;
+    /**
+     * @remarks
+     * Updates value of the entry.
+     *
+     * @param value
+     * New value.
+     */
+    setValue(value: ImageResourceData): void;
+}
+
+/**
+ * A property item which supports Sub Pane properties
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IListPanePropertyItem extends IPropertyItemBase, IPane {
+    /**
+     * @remarks
+     * Count of the slots managed by the list.
+     *
+     */
+    readonly slotCount: number;
+    /**
+     * @remarks
+     * Current sorting type for the pane slots
+     *
+     */
+    readonly viewSortType: ListPaneViewSortType;
+    /**
+     * @remarks
+     * Adds a new slot to the list.
+     *
+     */
+    addSlot(params: ListPaneSlotCreationProps): IListPaneSlot;
+    /**
+     * @remarks
+     * Finds the slot with the identifier.
+     *
+     * @param id
+     * Unique identifier of the slot.
+     */
+    getSlotById(id: string): IListPaneSlot | undefined;
+    /**
+     * @remarks
+     * Finds the slot with the index.
+     *
+     * @param index
+     * Index of the slot in the component list.
+     */
+    getSlotByIndex(index: number): IListPaneSlot | undefined;
+    /**
+     * @remarks
+     * @returns
+     * Active view filter
+     */
+    getViewFilter(): ListPaneViewFilter | undefined;
+    /**
+     * @remarks
+     * Removes the slot from the list.
+     *
+     * @param id
+     * Unique identifier of the slot.
+     */
+    removeSlot(id: string): void;
+    /**
+     * @remarks
+     * Selects slot by id.
+     *
+     * @param id
+     * Unique identifier of the slot.
+     * @param deselectOtherSlots
+     * Deselects already selected slots if defined.
+     */
+    selectSlot(id: string, deselectOtherSlots?: boolean): void;
+    /**
+     * @remarks
+     * Filters displaying slots to match the define properties
+     *
+     * @param filter
+     * Slots that don't match filter properties won't be included.
+     */
+    setViewFilter(filter: ListPaneViewFilter | undefined): void;
+    /**
+     * @remarks
+     * Updates how slots will be sorted in the view
+     *
+     * @param sortType
+     * New sort type, it undefined Default will be used.
+     */
+    setViewSortType(sortType: ListPaneViewSortType | undefined): void;
+    /**
+     * @remarks
+     * Updates all slots with the new list.
+     *
+     * @param newSlots
+     * Creation properties for the new slots.
+     */
+    updateSlots(newSlots: ListPaneSlotCreationProps[]): void;
+}
+
+/**
+ * Optional properties for List Pane property item
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IListPanePropertyItemOptions extends IPropertyItemOptionsBase {
+    /**
+     * @remarks
+     * This will be the height of the list withing the pane
+     *
+     */
+    defaultSlots?: ListPaneSlotCreationProps[];
+    /**
+     * @remarks
+     * This will be the height of the list withing the pane
+     *
+     */
+    height?: number;
+    /**
+     * @remarks
+     * Layout for the list will need to be predefined, and using
+     * wrong layout shape while creating slots will throw
+     *
+     */
+    layout: ListPaneSlotLayout;
+    /**
+     * @remarks
+     * This callback is fired whenever a clickable slot is pressed
+     *
+     */
+    onSlotClicked?: (slot: IListPaneSlot) => void;
+    /**
+     * @remarks
+     * This callback is fired whenever selected state of a slot is
+     * changed
+     *
+     */
+    onSlotSelectionChange?: (slot: IListPaneSlot, state: boolean) => void;
+    /**
+     * @remarks
+     * Localized title of the property item.
+     *
+     */
+    title?: LocalizedString;
+    /**
+     * @remarks
+     * Filter properties for viewing subset of slots.
+     *
+     */
+    viewFilter?: ListPaneViewFilter;
+    /**
+     * @remarks
+     * Sort type for the slots in the view. If undefined, default
+     * list order will be used.
+     *
+     */
+    viewSortType?: ListPaneViewSortType;
+}
+
+/**
+ * List Pane slot
+ */
+export interface IListPaneSlot {
+    /**
+     * @remarks
+     * Count of entries.
+     *
+     */
+    readonly entryCount: number;
+    /**
+     * @remarks
+     * Unique identifier of the slot.
+     *
+     */
+    readonly id: string;
+    /**
+     * @remarks
+     * Unique identifier of the parent pane.
+     *
+     */
+    readonly paneId: string;
+    /**
+     * @remarks
+     * Selected state of the slot.
+     *
+     */
+    readonly selected: boolean;
+    /**
+     * @remarks
+     * List of tags associated with the slot.
+     *
+     */
+    readonly tags: ReadonlyArray<string>;
+    /**
+     * @remarks
+     * Count of entries.
+     *
+     */
+    readonly title: LocalizedString;
+    /**
+     * @remarks
+     * Finds the entry with the index if it exists.
+     *
+     * @param index
+     * Sequence index of the entry in the slot.
+     * @param type
+     * Optional type check for the entry.
+     */
+    getEntry<K extends ListPaneEntryType | undefined = undefined>(
+        index: number,
+        type?: K,
+    ): (K extends ListPaneEntryType ? ListPaneEntryMap[K] : IListPaneEntry) | undefined;
+    /**
+     * @remarks
+     * @returns
+     * User data associated with the slot.
+     */
+    getUserData(): unknown;
+    /**
+     * @remarks
+     * Updates selected state of the slot.
+     *
+     * @param selected
+     * New selected state.
+     */
+    setSelected(selected: boolean): void;
+    /**
+     * @remarks
+     * Updates tags of the slot.
+     *
+     * @param tags
+     * New tag list.
+     */
+    setTags(tags: string[] | undefined): void;
+    /**
+     * @remarks
+     * Updates title of the slot.
+     *
+     * @param title
+     * New title.
+     */
+    setTitle(title: LocalizedString): void;
+    /**
+     * @remarks
+     * Updates user data associated with the slot
+     *
+     * @param data
+     * New user data.
+     */
+    setUserData(data: unknown): void;
+}
+
+/**
+ * List Pane slot optional properties
+ */
+export interface IListPaneSlotOptions {
+    /**
+     * @remarks
+     * List of tags associated with the slot.
+     *
+     */
+    tags?: string[];
+    /**
+     * @remarks
+     * Localized title of the slot.
+     *
+     */
+    title?: LocalizedString;
+    /**
+     * @remarks
+     * Unique identifier to use for the slot.
+     *
+     */
+    uniqueId?: string;
+    /**
+     * @remarks
+     * Optional user data that can be associated with a slot.
+     *
+     */
+    userData?: unknown;
+}
+
+/**
+ * List Pane text entry
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export interface IListPaneTextEntry extends IListPaneEntry {
+    /**
+     * @remarks
+     * Value of the entry.
+     *
+     */
+    readonly value: Readonly<LocalizedString>;
+    /**
+     * @remarks
+     * Updates value of the entry.
+     *
+     * @param value
+     * New value.
+     */
+    setValue(value: LocalizedString): void;
+}
+
 export interface IMenu {
     /**
      * @remarks
@@ -6380,6 +7015,102 @@ export interface IModalControlPane extends IPane {
     addDivider(): IPropertyItemBase;
 }
 
+export interface IModalDialog {
+    /**
+     * @remarks
+     * Identifier for the active request for this dialog
+     *
+     */
+    readonly activeRequestId: string | undefined;
+    /**
+     * @remarks
+     * Custom pane layout for the dialog
+     *
+     */
+    readonly contentPane: IPropertyPane;
+    /**
+     * @remarks
+     * Custom pane layout for the dialog
+     *
+     */
+    readonly controlPane: IModalControlPane;
+    /**
+     * @remarks
+     * Unique identifier for the dialog
+     *
+     */
+    readonly id: string;
+    /**
+     * @remarks
+     * Dispatches a dismiss message to the active request if it is
+     * available
+     *
+     */
+    sendDismiss(): void;
+    /**
+     * @remarks
+     * Dispatches a response message to the active request if it is
+     * available
+     *
+     * @param response
+     * Response message to be handled by the active request
+     */
+    sendResponse(response: ModalDialogCustomResponse): void;
+}
+
+/**
+ * Represents modal dialog state for the specific activation
+ * request
+ */
+export interface IModalDialogActivationRequest {
+    /**
+     * @remarks
+     * Unique identifier for the request
+     *
+     */
+    readonly id: string;
+    /**
+     * @remarks
+     * Determines if the request is still active
+     *
+     */
+    readonly isValid: boolean;
+    /**
+     * @remarks
+     * Cancels the request if it's still active
+     *
+     */
+    cancel(): void;
+}
+
+export interface IModalDialogManager {
+    /**
+     * @remarks
+     * Creates a modal activation request for an existing modal
+     * template
+     *
+     * @param params
+     * Activation parameters
+     */
+    activateDialog<T extends CoreModalDialogType | string>(
+        params: ModalDialogActivationParams<T>,
+    ): IModalDialogActivationRequest;
+    /**
+     * @remarks
+     * Removes the active modal from view
+     *
+     */
+    dismissActiveDialog(): void;
+    /**
+     * @remarks
+     * Creates a custom modal dialog with a property pane
+     *
+     * @param params
+     * Creation parameters
+     */
+    registerDialog(params: ModalDialogCreationParams): IModalDialog;
+}
+
 /**
  * A modal overlay pane is displayed over a root pane.
  */
@@ -7162,6 +7893,13 @@ export interface IPropertyPane extends IPane {
      *
      */
     addLink(value: IObservableProp<string>, options?: ILinkPropertyItemOptions): ILinkPropertyItem;
+    /**
+     * @remarks
+     * Adds a pane for displaying list of items in a predefined
+     * layout.
+     *
+     */
+    addListPane(options: IListPanePropertyItemOptions): IListPanePropertyItem;
     /**
      * @remarks
      * Adds a menu button property item to the pane.
@@ -8076,6 +8814,49 @@ export interface LogProperties {
     tags?: string[];
 }
 
+/**
+ * Represents parameters to create a modal dialog
+ */
+export interface ModalDialogCreationParams {
+    /**
+     * @remarks
+     * Determines if the panel can be dismissed by the user
+     * actions. If undefined, it will be true.
+     *
+     */
+    canUserDismiss?: boolean;
+    /**
+     * @remarks
+     * Panel height for the dialog
+     *
+     */
+    height?: number;
+    /**
+     * @remarks
+     * Callback to notify changes in active request
+     *
+     */
+    onActiveRequestChange?: (requestId: string | undefined) => void;
+    /**
+     * @remarks
+     * Dialog title
+     *
+     */
+    title?: LocalizedString;
+    /**
+     * @remarks
+     * Optional user defined unique identifier
+     *
+     */
+    uniqueId?: string;
+    /**
+     * @remarks
+     * Panel width for the dialog
+     *
+     */
+    width?: number;
+}
+
 /**
  * Parameters for creating a modal tool in the tool container
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server-editor",
-  "version": "0.1.0-beta.1.21.120-preview.25",
+  "version": "0.1.0-beta.1.21.130-preview.22",
   "description": "",
   "contributors": [
     {
@@ -14,8 +14,8 @@
   ],
   "peerDependencies": {
     "@minecraft/common": "^1.0.0",
-    "@minecraft/server": "^2.4.0-beta.1.21.120-preview.25",
-    "@minecraft/vanilla-data": ">=1.20.70 || 1.21.120-preview.25"
+    "@minecraft/server": "^2.5.0-beta.1.21.130-preview.22",
+    "@minecraft/vanilla-data": ">=1.20.70 || 1.21.130-preview.22"
   },
   "license": "MIT"
 }