@wix/react-component-schema 1.8.0 → 1.9.0

package/dist/index.d.ts

@@ -57,7 +57,9 @@ declare enum A11yAttributes {
     /** The value used for aria-multiline */
     ariaMultiline = "ariaMultiline",
     /** The value used for aria-invalid */
-    ariaInvalid = "ariaInvalid"
+    ariaInvalid = "ariaInvalid",
+    /** The value used for lang attribute */
+    lang = "lang"
 }
 
 export declare type Action = ApiAction;
@@ -116,7 +118,8 @@ declare enum ActionType {
     style = "style",
     displayGroup = "displayGroup",
     cssProperty = "cssProperty",
-    cssCustomProperty = "cssCustomProperty"
+    cssCustomProperty = "cssCustomProperty",
+    dashboard = "dashboard"
 }
 
 declare interface ApiAction {
@@ -127,6 +130,11 @@ declare interface ApiAction {
     displayName?: string;
     /** A model definition for declaring a concrete instructions action will perform */
     execution?: Execution;
+    /**
+     * A description of this action
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 /** @oneof */
@@ -137,7 +145,7 @@ declare interface ApiArrayItemsArrayDataOneOf {
     dataItem?: DataItem;
     /**
      * Marks this array as one whose item types are dynamic and resolved at runtime.
-     * Only applicable when a template container (containerType = TEMPLATE) has a data_item_key
+     * Only applicable when a template container (containerType = TEMPLATE) has an item_key
      * that references this array. Mutually exclusive with 'data' and 'data_item'.
      */
     dynamicItems?: boolean | null;
@@ -155,6 +163,20 @@ declare interface ApiBackgroundImage {
     vectorArtCategory?: VectorArtCategoryTypes;
 }
 
+declare interface ApiContext {
+    /** A map of keys describing the context provided by this component */
+    items?: Record<string, ContextItem>;
+    /** Named preview states this context can be rendered in, keyed by state key */
+    states?: Record<string, ContextState>;
+    /** Display groups for the top-level context items, used to group and order them in the editor for better UX */
+    displayGroups?: Record<string, ContextDisplayGroup>;
+    /**
+     * Human friendly name of the context for human readability
+     * @maxLength 50
+     */
+    displayName?: string | null;
+}
+
 export declare enum ARCHETYPE {
     UNKNOWN_Archetype = "UNKNOWN_Archetype",
     Button = "Button",
@@ -208,7 +230,7 @@ export declare interface ArrayItems extends ApiArrayItemsArrayDataOneOf {
     dataItem?: DataItem;
     /**
      * Marks this array as one whose item types are dynamic and resolved at runtime.
-     * Only applicable when a template container (containerType = TEMPLATE) has a data_item_key
+     * Only applicable when a template container (containerType = TEMPLATE) has an item_key
      * that references this array. Mutually exclusive with 'data' and 'data_item'.
      */
     dynamicItems?: boolean | null;
@@ -421,6 +443,11 @@ export declare const ButtonVariableNames: {
     readonly 'wst-button-tertiary-text-highlight': "wst-button-tertiary-text-highlight";
 };
 
+declare interface ChangeEvent {
+    /** The type of input this change event originates from */
+    inputType?: InputTypeEnumInputType;
+}
+
 declare interface ClientResources {
     /**
      * A URL to an ESM javascript bundle. It's default export should be the component
@@ -582,6 +609,126 @@ declare enum ContentResizeDirection {
     none = "none"
 }
 
+/** An array of data items or complex data types */
+declare interface ContextArrayItems extends ContextArrayItemsArrayDataOneOf {
+    /** Specify the type of data inside the array */
+    item?: ContextItem;
+}
+
+/** @oneof */
+declare interface ContextArrayItemsArrayDataOneOf {
+    /** Specify the type of data inside the array */
+    item?: ContextItem;
+}
+
+/** A map of keys describing the context items provided by this component */
+declare interface ContextDataItems {
+    /** A map of keys describing the data items provided by this component */
+    items?: Record<string, ContextItem>;
+    /** For sub types that implement parts of context, points to a context provider component type */
+    contextImplementor?: ContextImplementor;
+    /** Display groups for this context-data object's own items, used to group and order them in the editor for better UX */
+    displayGroups?: Record<string, ContextDisplayGroup>;
+}
+
+/** A labeled, ordered grouping of context items, used to group and order them in the editor for better UX */
+declare interface ContextDisplayGroup {
+    /**
+     * Display name for this group, shown in the editor
+     * @maxLength 20
+     */
+    displayName?: string | null;
+    /**
+     * The context items in this group, referenced by their key in the items map of the enclosing message
+     * (Context or ContextDataItems). Reuses the same ItemsGroup mechanism as editor-react display groups;
+     * array order defines the display/sort order.
+     */
+    items?: ItemsGroup;
+}
+
+declare interface ContextImplementor {
+    /**
+     * The component type to implement the context item
+     * @maxLength 100
+     */
+    componentType?: string;
+    /**
+     * The prop key the component expects the context to be passed in to it (optional)
+     * @maxLength 100
+     */
+    propKey?: string | null;
+}
+
+declare interface ContextItem extends ContextItemSelectedDataTypeOneOf {
+    /** For arrays, the items are defined here */
+    arrayItems?: ContextArrayItems;
+    /** For data objects, the items are defined here */
+    data?: ContextDataItems;
+    /** For functions, the function definition is defined here */
+    function?: EditorFunction;
+    /** For text enums, the enum options are defined here */
+    textEnum?: TextEnum;
+    /** The type exposed by the context item (can't be "container") */
+    dataType?: DataType;
+    /**
+     * The display name of the context item for user facing and AI usage
+     * @maxLength 100
+     */
+    displayName?: string | null;
+    /** For sub types that implement parts of context, points to a context provider component type */
+    contextImplementor?: ContextImplementor;
+    /* Excluded from this release type: deprecated */
+    /* Excluded from this release type: spec */
+    /**
+     * A description of the context item for user facing and AI usage
+     * @maxLength 300
+     */
+    description?: string | null;
+}
+
+/** @oneof */
+declare interface ContextItemSelectedDataTypeOneOf {
+    /** For arrays, the items are defined here */
+    arrayItems?: ContextArrayItems;
+    /** For data objects, the items are defined here */
+    data?: ContextDataItems;
+    /** For functions, the function definition is defined here */
+    function?: EditorFunction;
+    /** For text enums, the enum options are defined here */
+    textEnum?: TextEnum;
+}
+
+declare interface ContextReferences {
+    /**
+     * Available contexts in this container that were defined in the editorElement.contexts
+     * Example: itemsList
+     */
+    local?: string[];
+    /**
+     * A list of contexts this component exposes because it uses other context providers inside it's code
+     * Example: @wix/stores-products-list-context
+     */
+    reference?: string[];
+}
+
+/** A named preview state this context can be rendered in */
+declare interface ContextState {
+    /**
+     * Display name of this state for user facing and AI usage
+     * @maxLength 100
+     */
+    displayName?: string | null;
+    /**
+     * A description of this state for user facing and AI usage
+     * @maxLength 300
+     */
+    description?: string | null;
+    /** The props to apply to activate this state */
+    props?: Record<string, any>;
+    /** The context item whose value the context applies in this state, given the props */
+    contextItem?: StateContextItem;
+}
+
 export declare interface Coordinates {
     /**
      * Stores the top coordinate of the property shorthand
@@ -709,6 +856,12 @@ export declare interface CssCustomPropertyItem extends CssCustomPropertyItemSele
     defaultValue?: any;
     /** The default values for the css-property-item when the component is in one of the defined states */
     statesDefaultValues?: Record<string, any>;
+    /**
+     * A description of this css-custom-property-item
+     * @maxLength 300
+     */
+    description?: string | null;
+    /* Excluded from this release type: spec */
 }
 
 /** @oneof */
@@ -989,6 +1142,12 @@ export declare interface CssPropertyItem extends CssPropertyItemSelectedCssPrope
     /** The default values for the css-property-item when the component is in one of the defined states */
     statesDefaultValues?: Record<string, any>;
     /* Excluded from this release type: deprecated */
+    /**
+     * A description of this css-property-item
+     * @maxLength 300
+     */
+    description?: string | null;
+    /* Excluded from this release type: spec */
 }
 
 declare interface CssPropertyItemDefaults {
@@ -1010,6 +1169,11 @@ export declare interface CssPropertyItemDefinitionOverrides {
     defaultValue?: any;
     /** The default values for the css-property-item when the component is in one of the defined states */
     statesDefaultValues?: Record<string, any>;
+    /**
+     * A description of this css-property-item
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 /** @oneof */
@@ -1200,6 +1364,34 @@ declare interface CustomEnumOptionCssProperty {
     value?: string;
 }
 
+/** A custom filter operator definition beyond the built-in FilterOperator set */
+declare interface CustomFilterOperator {
+    /**
+     * The operator name as it will be passed in the filter object in the component's props.
+     * Use the bare operator name without the leading `$` (e.g. `eq`, not `$eq`),
+     * matching the FilterOperator enum convention.
+     * @maxLength 20
+     */
+    name?: string | null;
+    /**
+     * Human-readable display name for this custom operator
+     * @maxLength 100
+     */
+    displayName?: string | null;
+    /**
+     * A description of this custom filter operator
+     * @maxLength 300
+     */
+    description?: string | null;
+    /**
+     * The value type this operator expects. When omitted, the operator is passed
+     * with no value.
+     */
+    valueType?: FilterOperatorValueType;
+    /** In case of text enum - a required list of options to supply to the users to choose from */
+    textEnum?: TextEnum;
+}
+
 export declare interface CustomPropertyEnum {
     /** The type of the css-custom-property, used to define the type of the values allowed in the enum */
     cssPropertyType?: CssPropertyEnumCssPropertyType;
@@ -1222,6 +1414,11 @@ export declare interface CustomPropertyEnumOption {
      */
     displayName?: string | null;
     /* Excluded from this release type: appliedStyles */
+    /**
+     * A description of this enum option
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 declare interface CustomPropertyEnumOptionStyle {
@@ -1253,6 +1450,42 @@ export declare interface DashboardAction {
     dashboardPageId?: string;
     /** A model definition for declaring a concrete instructions action will perform */
     execution?: Execution;
+    /**
+     * A description of this dashboard action
+     * @maxLength 300
+     */
+    description?: string | null;
+}
+
+/**
+ * A dashboard (back-office) target - the page id only. Unlike DashboardAction
+ * (which embeds an Execution), this leaf carries no nested Execution, so it can
+ * be referenced from Execution (as a `dashboard` execution) without a cycle.
+ */
+declare interface DashboardPageAction {
+    /**
+     * pageId of the dashboard in case there is more than one
+     * @minLength 4
+     * @maxLength 50
+     */
+    dashboardPageId?: string;
+    /** Optional pre-defined anchor within the page, and values for its expected url params */
+    pageAnchor?: DashboardPageAnchor;
+}
+
+/**
+ * A pre-defined anchor (e.g. a tab/section) within a dashboard page, along with
+ * values for the url params that anchor expects.
+ */
+declare interface DashboardPageAnchor {
+    /**
+     * The id of the pre-defined anchor (PageAnchor.id), used to reference it externally
+     * @minLength 1
+     * @maxLength 50
+     */
+    id?: string;
+    /** Values for the pre-defined url params expected by this anchor, keyed by param name */
+    urlParams?: Record<string, string>;
 }
 
 /**
@@ -1322,6 +1555,10 @@ export declare interface DataItem extends DataItemSelectedDataTypeOneOf {
     data?: DataItems;
     /** A definition of a custom function */
     function?: EditorFunction;
+    /** A definition of what fields are available for filtering */
+    filter?: FilterDefinition;
+    /** A definition of what fields are available for sorting */
+    sort?: SortDefinition;
     /** Defines the type of data we are configuring */
     dataType?: DataType;
     /**
@@ -1332,8 +1569,14 @@ export declare interface DataItem extends DataItemSelectedDataTypeOneOf {
     /** The default value of this data item (only for display purposes). */
     defaultValue?: any;
     /* Excluded from this release type: deprecated */
+    /* Excluded from this release type: spec */
     /** Disables the ability to delete this data-item value in the Editor UI */
     disableDeletion?: boolean | null;
+    /**
+     * A description of this data item
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 declare interface DataItemOverrides extends DataItemOverridesSelectedDataTypeOneOf {
@@ -1354,6 +1597,11 @@ declare interface DataItemOverrides extends DataItemOverridesSelectedDataTypeOne
     displayName?: string | null;
     /** Overrides the ability to delete this data-item value in the Editor UI */
     disableDeletion?: boolean | null;
+    /**
+     * Overrides the description of this data-item
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 /** @oneof */
@@ -1402,6 +1650,10 @@ declare interface DataItemSelectedDataTypeOneOf {
     data?: DataItems;
     /** A definition of a custom function */
     function?: EditorFunction;
+    /** A definition of what fields are available for filtering */
+    filter?: FilterDefinition;
+    /** A definition of what fields are available for sorting */
+    sort?: SortDefinition;
 }
 
 export declare type DataItemsMap = NonNullable<DataItems['items']>;
@@ -1500,16 +1752,24 @@ declare enum DataType {
     data = "data",
     /** A custom function that can be used to call a function from a custom library */
     'function' = "function",
-    /** Standard [onClick handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event), can also handle: `()=>void` */
+    /** Deprecated: use function with pointerEvent parameter. Standard [onClick handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event) */
     onClick = "onClick",
-    /** Standard input event [onChange](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event) for text inputs, can also handle: `(value: string) => void` */
+    /** Deprecated: use function with changeEvent parameter. Standard [onChange handler](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event) */
     onChange = "onChange",
-    /** Standard [onKeyPress handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/keypress_event), can also handle: `(event: KeyboardEvent) => void` */
+    /** Deprecated: use function with keyboardEvent parameter. Standard [onKeyPress handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/keypress_event) */
     onKeyPress = "onKeyPress",
-    /** Standard [onKeyUp handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/keyup_event), can also handle: `(event: KeyboardEvent) => void` */
+    /** Deprecated: use function with keyboardEvent parameter. Standard [onKeyUp handler](https://developer.mozilla.org/en-US/docs/Web/API/Element/keyup_event) */
     onKeyUp = "onKeyUp",
-    /** Standard [onSubmit handler](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/submit_event), can also handle: `() => void` */
-    onSubmit = "onSubmit"
+    /** Deprecated: use function with submitEvent parameter. Standard [onSubmit handler](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/submit_event) */
+    onSubmit = "onSubmit",
+    /** A WQL-compliant filter definition for querying data */
+    filter = "filter",
+    /** A WQL-compliant sort definition for ordering data */
+    sort = "sort",
+    /** A media type that is ONLY used for binding and not stored in the document store of the site */
+    visualMedia = "visualMedia",
+    /** RicosDocument object type. */
+    ricosDocument = "ricosDocument"
 }
 
 declare interface DefaultPresets {
@@ -1595,6 +1855,8 @@ declare interface DisplayFilters_2 {
     cssCustomProperties?: DisplayFilter;
     /** DisplayFilter for states, defines which states to hide or show, uses the state key in the states map, optional */
     states?: DisplayFilter;
+    /** DisplayFilter for presets, defines which presets to hide or show, uses the preset key in the presets map, optional */
+    presets?: DisplayFilter;
 }
 
 /**
@@ -1613,14 +1875,16 @@ declare interface DisplayGroupAction {
 export declare interface DisplayGroupItem extends DisplayGroupItemSelectedGroupTypeOneOf {
     /** A group that contains cssCustomProperties items that used one of the supported css-data-types (length, angle, number, ..._) */
     cssDataType?: ItemsGroup;
-    /** A group that contains data items */
+    /** A group that contains data items, should be used for grouping and ordering purposes in the editor */
     data?: ItemsGroup;
     /** A group that contains preset items, which will be displayed in the editor as a category in the presets panel */
     presets?: ItemsGroup;
-    /** A group that contains cssCustomProperties items that use the same cssPropertyType, should be used mostly for ordering purposes */
+    /** A group that contains cssCustomProperties items that use the same cssPropertyType, should be used for grouping and ordering purposes */
     cssCustomProperties?: ItemsGroup;
-    /** A group that contains other displayGroups items that use the same groupType,  should be used mostly for ordering purposes */
+    /** A group that contains other displayGroups items that use the same groupType, should be used for ordering purposes */
     displayGroups?: ItemsGroup;
+    /** A group that contains elements that belong to the current element in the component, array order defines the display order to the elements in panels. Each item is the element name. */
+    elements?: ItemsGroup;
     /** A group that contains background items */
     background?: ShorthandGroupBackground;
     /** A group that contains margin items */
@@ -1657,6 +1921,8 @@ export declare interface DisplayGroupItem extends DisplayGroupItemSelectedGroupT
     borderStyle?: Coordinates;
     /** a group that contains items related to text */
     text?: TextGroup;
+    /** A group that contains items related to stroke */
+    stroke?: StrokeGroup;
     /** A group that contains data-items related to arrayItems, will be used for enhancing the editor experience when editing them */
     arrayItems?: DataGroupsArrayItems;
     /** A group that contains common data-items that are used within array-item objects, will be used for enhancing the editor experience when editing them */
@@ -1668,20 +1934,27 @@ export declare interface DisplayGroupItem extends DisplayGroupItemSelectedGroupT
     displayName?: string | null;
     /** The type of the group, used to determine the group that will be displayed in the editor */
     groupType?: GroupType;
+    /**
+     * A description of this Group
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 /** @oneof */
 declare interface DisplayGroupItemSelectedGroupTypeOneOf {
     /** A group that contains cssCustomProperties items that used one of the supported css-data-types (length, angle, number, ..._) */
     cssDataType?: ItemsGroup;
-    /** A group that contains data items */
+    /** A group that contains data items, should be used for grouping and ordering purposes in the editor */
     data?: ItemsGroup;
     /** A group that contains preset items, which will be displayed in the editor as a category in the presets panel */
     presets?: ItemsGroup;
-    /** A group that contains cssCustomProperties items that use the same cssPropertyType, should be used mostly for ordering purposes */
+    /** A group that contains cssCustomProperties items that use the same cssPropertyType, should be used for grouping and ordering purposes */
     cssCustomProperties?: ItemsGroup;
-    /** A group that contains other displayGroups items that use the same groupType,  should be used mostly for ordering purposes */
+    /** A group that contains other displayGroups items that use the same groupType, should be used for ordering purposes */
     displayGroups?: ItemsGroup;
+    /** A group that contains elements that belong to the current element in the component, array order defines the display order to the elements in panels. Each item is the element name. */
+    elements?: ItemsGroup;
     /** A group that contains background items */
     background?: ShorthandGroupBackground;
     /** A group that contains margin items */
@@ -1718,6 +1991,8 @@ declare interface DisplayGroupItemSelectedGroupTypeOneOf {
     borderStyle?: Coordinates;
     /** a group that contains items related to text */
     text?: TextGroup;
+    /** A group that contains items related to stroke */
+    stroke?: StrokeGroup;
     /** A group that contains data-items related to arrayItems, will be used for enhancing the editor experience when editing them */
     arrayItems?: DataGroupsArrayItems;
     /** A group that contains common data-items that are used within array-item objects, will be used for enhancing the editor experience when editing them */
@@ -1751,7 +2026,15 @@ declare enum DisplayValueEnumDisplayValue {
     inlineTable = "inlineTable",
     inlineFlex = "inlineFlex",
     inlineGrid = "inlineGrid",
-    listItem = "listItem"
+    listItem = "listItem",
+    tableRowGroup = "tableRowGroup",
+    tableHeaderGroup = "tableHeaderGroup",
+    tableFooterGroup = "tableFooterGroup",
+    tableRow = "tableRow",
+    tableCell = "tableCell",
+    tableColumnGroup = "tableColumnGroup",
+    tableColumn = "tableColumn",
+    tableCaption = "tableCaption"
 }
 
 export declare const DOM_EVENT: {
@@ -1764,6 +2047,20 @@ export declare const DOM_EVENT: {
 
 export declare type DomEvent = (typeof DOM_EVENT)[keyof typeof DOM_EVENT];
 
+declare enum DomEventType {
+    UNKNOWN_DomEventType = "UNKNOWN_DomEventType",
+    /** Value change event (https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event) */
+    CHANGE = "CHANGE",
+    /** Pointer interaction event (https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent) */
+    POINTER = "POINTER",
+    /** Keyboard interaction event (https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent) */
+    KEYBOARD = "KEYBOARD",
+    /** Focus and blur event (https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent) */
+    FOCUS = "FOCUS",
+    /** Form submission event (https://developer.mozilla.org/en-US/docs/Web/API/SubmitEvent) */
+    SUBMIT = "SUBMIT"
+}
+
 declare interface EditorDependencies {
     /**
      * A list of service dependencies required by the component, example: ['@wix/environment']
@@ -1789,7 +2086,11 @@ export declare type EditorElement = EditorElement_2 & RequiredFields<EditorEleme
     presets?: Record<string, PresetItem>;
 };
 
-declare interface EditorElement_2 {
+declare interface EditorElement_2 extends EditorElementSelectedPartElementTypeOneOf {
+    /** Media-specific selectors for parts of type media */
+    media?: PartMedia;
+    /** Container-specific selectors for parts of type container */
+    container?: PartContainer;
     /**
      * DOM Query selector for this element that we can use to find it when rendering it (preferably  a className)
      * @minLength 4
@@ -1803,6 +2104,8 @@ declare interface EditorElement_2 {
     displayName?: string;
     /** data-api of this element, a map of data-items where the key is the data-item name and the value is the data-item definition. These will be manifested as `props` for the component */
     data?: Record<string, DataItem>;
+    /** A map of contexts this component exposes inside containers it supports */
+    contexts?: Record<string, ApiContext>;
     /** elements-map of this element, a map of inner-elements where the key is the element name and the value is the element definition */
     elements?: Record<string, ElementItem>;
     /** Native actions specified for the component */
@@ -1832,6 +2135,13 @@ declare interface EditorElement_2 {
     cssCustomProperties?: Record<string, CssCustomPropertyItem>;
     /** A reference to a help article for this element */
     helpArticle?: HelpArticle;
+    /**
+     * A description of the editor element
+     * @maxLength 300
+     */
+    description?: string | null;
+    /** The semantic part-type of this element. */
+    partType?: PartType;
 }
 
 /** Top-level message containing all layout capabilities */
@@ -1852,6 +2162,14 @@ export declare interface EditorElementLayout {
     disableDuplication?: boolean | null;
 }
 
+/** @oneof */
+declare interface EditorElementSelectedPartElementTypeOneOf {
+    /** Media-specific selectors for parts of type media */
+    media?: PartMedia;
+    /** Container-specific selectors for parts of type container */
+    container?: PartContainer;
+}
+
 declare interface EditorFunction {
     /**
      * The Parameters expected by the function, can be empty
@@ -1873,6 +2191,8 @@ declare interface EditorFunction {
      */
     description?: string | null;
     /* Excluded from this release type: deprecated */
+    /** The role of the function, describing the purpose it serves */
+    role?: FunctionRole;
 }
 
 /** The full model for an imported component set in DEV Center */
@@ -1897,6 +2217,8 @@ export declare interface EditorReactComponent {
     installation?: InstallationInfo;
     /** Module configuration for NPM-based component */
     moduleConfiguration?: EditorReactComponentModuleConfiguration;
+    /* Excluded from this release type: schemaUrl */
+    /* Excluded from this release type: managingAppId */
 }
 
 declare interface EditorReactComponentModuleConfiguration {
@@ -1917,21 +2239,32 @@ declare enum EffectGroup {
 }
 
 export declare interface ElementItem extends ElementItemSelectedElementTypeOneOf {
-    /** An new element definition */
+    /** A new element definition */
     inlineElement?: InlineElement;
     /** A reference to the used element with overrides */
     refElement?: RefElement;
+    /**
+     * A visual only element that requires a semantic part definition.
+     * Should be used when the current element has several visual elements that need to be targeted separately for styling or animations
+     */
+    partElement?: PartElement;
     /** Defines the type of element we are configuring */
     elementType?: ElementTypeEnumElementType;
     /* Excluded from this release type: deprecated */
+    /* Excluded from this release type: spec */
 }
 
 /** @oneof */
 declare interface ElementItemSelectedElementTypeOneOf {
-    /** An new element definition */
+    /** A new element definition */
     inlineElement?: InlineElement;
     /** A reference to the used element with overrides */
     refElement?: RefElement;
+    /**
+     * A visual only element that requires a semantic part definition.
+     * Should be used when the current element has several visual elements that need to be targeted separately for styling or animations
+     */
+    partElement?: PartElement;
 }
 
 export declare const ELEMENTS: {
@@ -1964,14 +2297,11 @@ declare interface ElementState {
     displayFilters?: DisplayFilters_2;
     /** The element that needs to be targeted when this state is applied */
     target?: TargetElement;
-}
-
-/** DEPRECATED: This message is deprecated and will be removed in the future */
-declare interface ElementStyleDefaults {
-    /** The default styles for an element */
-    style?: Record<string, StyleItemDefaults>;
-    /** The default preset and styles for inner elements */
-    elements?: Record<string, ElementStyleDefaults>;
+    /**
+     * A description of this state
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 declare interface ElementStyleOverrides {
@@ -1980,13 +2310,6 @@ declare interface ElementStyleOverrides {
      * @maxLength 100
      */
     presetKey?: string | null;
-    /**
-     * The override styles for an element
-     * @deprecated The override styles for an element
-     * @replacedBy cssProperties or cssCustomProperties
-     * @targetRemovalDate 2025-08-01
-     */
-    style?: Record<string, PresetStyleItemOverrides>;
     /** The override preset and styles for inner elements */
     elements?: Record<string, ElementStyleOverrides>;
     /** The default values for the element css-properties when the preset is selected */
@@ -2000,7 +2323,9 @@ declare enum ElementTypeEnumElementType {
     /** An element that was written as part of the component */
     inlineElement = "inlineElement",
     /** An element provided by the Wix ecosystem that we are reusing. These elements must exist in the Wix DEV Center. */
-    refElement = "refElement"
+    refElement = "refElement",
+    /** A component's part element definition */
+    partElement = "partElement"
 }
 
 /** Executes an event-based action. Triggered event should be intercepted in the editor script */
@@ -2035,6 +2360,11 @@ export declare interface Execution extends ExecutionActionExecuteOneOf {
     cssProperty?: CssPropertyAction;
     /** Executes an action that points into a specific css-custom-property-key, */
     cssCustomProperty?: CssCustomPropertyAction;
+    /**
+     * Opens a back-office (dashboard) page. References the DashboardPageAction
+     * leaf (page id only) - it carries no nested Execution, so Execution stays acyclic.
+     */
+    dashboard?: DashboardPageAction;
     /** The action type allows to determine the return type of the execution function */
     actionType?: ActionType;
 }
@@ -2062,6 +2392,11 @@ declare interface ExecutionActionExecuteOneOf {
     cssProperty?: CssPropertyAction;
     /** Executes an action that points into a specific css-custom-property-key, */
     cssCustomProperty?: CssCustomPropertyAction;
+    /**
+     * Opens a back-office (dashboard) page. References the DashboardPageAction
+     * leaf (page id only) - it carries no nested Execution, so Execution stays acyclic.
+     */
+    dashboard?: DashboardPageAction;
 }
 
 export declare interface Filter {
@@ -2072,6 +2407,16 @@ export declare interface Filter {
     filterFunctions?: FilterFunction[];
 }
 
+/** Filter type - declares which items are filterable and which operators each item supports */
+declare interface FilterDefinition {
+    /** Fully described inline filter items */
+    inlineItems?: InlineFilterItem[];
+    /** Filter items referencing existing data items */
+    dataItems?: FilterItem[];
+    /** Filter items referencing existing context items */
+    contextItems?: FilterItem[];
+}
+
 declare enum FilterFunction {
     UNKNOWN_FilterFunctions = "UNKNOWN_FilterFunctions",
     /** The value used for blur filter */
@@ -2100,6 +2445,71 @@ declare enum FilterFunction {
     hueRotate = "hueRotate"
 }
 
+/** A filter item referencing an existing item (e.g. DataItem or ContextItem) */
+declare interface FilterItem {
+    /** Path to the item */
+    itemPath?: ItemPath;
+    /** Explicitly supported operators. If omitted, all applicable operators for the resolved type are assumed */
+    operators?: FilterOperator[];
+    /**
+     * Additional custom operators beyond the built-in FilterOperator set.
+     * @maxSize 10
+     */
+    customOperators?: CustomFilterOperator[];
+    /** Configures this filter item as an item-selection field */
+    itemSelection?: ItemSelectionConfig;
+}
+
+declare enum FilterOperator {
+    UNKNOWN_FilterOperator = "UNKNOWN_FilterOperator",
+    /** $eq - Equal */
+    eq = "eq",
+    /** $ne - Not equal */
+    ne = "ne",
+    /** $lt - Less than */
+    lt = "lt",
+    /** $lte - Less than or equal */
+    lte = "lte",
+    /** $gt - Greater than */
+    gt = "gt",
+    /** $gte - Greater than or equal */
+    gte = "gte",
+    /** $in - Value is in list */
+    'in' = "in",
+    /** $nin - Value is not in list */
+    nin = "nin",
+    /** $exists - Field exists (is not null) */
+    exists = "exists",
+    /** $isEmpty - Field value is empty */
+    isEmpty = "isEmpty",
+    /** $startsWith - String starts with (text fields only) */
+    startsWith = "startsWith",
+    /** $hasAll - Array contains all values */
+    hasAll = "hasAll",
+    /** $hasSome - Array contains at least one value */
+    hasSome = "hasSome",
+    /** $matchItems - Filter on inner fields of array items (arrayItems only) */
+    matchItems = "matchItems"
+}
+
+declare enum FilterOperatorValueType {
+    UNKNOWN_FilterOperatorValueType = "UNKNOWN_FilterOperatorValueType",
+    /** A simple text value */
+    text = "text",
+    /** A list of predefined textual values to choose from */
+    textEnum = "textEnum",
+    /** Any number */
+    number = "number",
+    /** true / false value */
+    booleanValue = "booleanValue",
+    /** Local date output ISO-8601 extended local date format (YYYY-MM-DD) */
+    localDate = "localDate",
+    /** Local time output ISO-8601 extended local time format (hh:mm[:ss][.sss]) */
+    localTime = "localTime",
+    /** Local Date Time output ISO-8601 extended local date-time format (YYYY-MM-DDThh:mm[:ss][.sss]) */
+    localDateTime = "localDateTime"
+}
+
 /** Fixed position builder for component installation */
 declare interface FixedPositionBuilder {
     /** Vertical position in the browser window */
@@ -2183,8 +2593,17 @@ declare interface FunctionParameter extends FunctionParameterSelectedDataTypeOne
     function?: EditorFunction;
     /** In case of a text enum */
     textEnum?: TextEnum;
-    /** The type of the Parameter, does not include containers */
+    /** In case of a Change event parameter */
+    changeEvent?: ChangeEvent;
+    /** In case of a link */
+    link?: Link;
+    /**
+     * Exactly one of `data_type` or `dom_event` must be set
+     * A data type parameter
+     */
     dataType?: DataType;
+    /** A DOM event parameter */
+    domEvent?: DomEventType;
     /** Whether the Parameter is optional, limitations of Javascript apply, only the last parameters can be optional */
     optional?: boolean | null;
     /**
@@ -2232,6 +2651,10 @@ declare interface FunctionParameterSelectedDataTypeOneOf {
     function?: EditorFunction;
     /** In case of a text enum */
     textEnum?: TextEnum;
+    /** In case of a Change event parameter */
+    changeEvent?: ChangeEvent;
+    /** In case of a link */
+    link?: Link;
 }
 
 declare interface FunctionReturnType extends FunctionReturnTypeSelectedDataTypeOneOf {
@@ -2265,6 +2688,14 @@ declare interface FunctionReturnTypeSelectedDataTypeOneOf {
     textEnum?: TextEnum;
 }
 
+declare enum FunctionRole {
+    UNKNOWN_FUNCTION_ROLE = "UNKNOWN_FUNCTION_ROLE",
+    /** The function converts between two data types, mostly useful for context providers and function libraries */
+    data_type_conversion = "data_type_conversion",
+    /** The function handles loading more items in a paginated list */
+    pagination_load_next_page = "pagination_load_next_page"
+}
+
 export declare interface Gap {
     /**
      * Stores the row-gap property of the gap shorthand
@@ -2294,6 +2725,7 @@ declare enum GroupType {
     presets = "presets",
     cssCustomProperties = "cssCustomProperties",
     displayGroups = "displayGroups",
+    elements = "elements",
     /** Style Shorthand Groups */
     background = "background",
     margin = "margin",
@@ -2314,6 +2746,7 @@ declare enum GroupType {
     gap = "gap",
     /** Mixed Variables Groups */
     text = "text",
+    stroke = "stroke",
     /** Data Groups */
     arrayItems = "arrayItems",
     /** Deprecated, use `listItem` instead */
@@ -2396,9 +2829,13 @@ declare interface InitialSizeSettingSelectedSizingTypeOneOf {
     pixels?: number;
 }
 
-export declare interface InlineElement {
+export declare interface InlineElement extends InlineElementSelectedPartElementTypeOneOf {
+    /** Media-specific selectors for parts of type media */
+    media?: PartMedia;
+    /** Container-specific selectors for parts of type container */
+    container?: PartContainer;
     /**
-     * Relative DOM Query selector for this element to the component root. We assume nesting by it's parent elements for CSS Vars scoping.
+     * Relative DOM Query selector for this element to the component root. We assume nesting by its parent elements for CSS Vars scoping.
      * @minLength 4
      * @maxLength 300
      */
@@ -2441,6 +2878,95 @@ export declare interface InlineElement {
     cssCustomProperties?: Record<string, CssCustomPropertyItem>;
     /** A reference to a help article for this element */
     helpArticle?: HelpArticle;
+    /**
+     * A description of this inline element
+     * @maxLength 300
+     */
+    description?: string | null;
+    /** The semantic part-type of this element. */
+    partType?: PartType;
+}
+
+/** @oneof */
+declare interface InlineElementSelectedPartElementTypeOneOf {
+    /** Media-specific selectors for parts of type media */
+    media?: PartMedia;
+    /** Container-specific selectors for parts of type container */
+    container?: PartContainer;
+}
+
+/** An inline filter item definition */
+declare interface InlineFilterItem {
+    /**
+     * Name of the filtered field
+     * @maxLength 200
+     */
+    name?: string | null;
+    /**
+     * Human-readable name for this field
+     * @maxLength 100
+     */
+    displayName?: string | null;
+    /** The data type of the field (subset of DataType suitable for filtering) */
+    dataType?: DataType;
+    /** Explicitly supported operators. If omitted, all applicable operators for the fieldType are assumed */
+    operators?: FilterOperator[];
+    /**
+     * Additional custom operators beyond the built-in FilterOperator set.
+     * @maxSize 10
+     */
+    customOperators?: CustomFilterOperator[];
+    /**
+     * A description of this filter field
+     * @maxLength 300
+     */
+    description?: string | null;
+    /**
+     * Configures this text filter field as an item-selection field, populated by an items provider implementing the Items
+     * Selection SPI (wix.items_selection.spi_host.v1). provider_key picks the provider; for multi-select use an array item.
+     */
+    itemSelection?: ItemSelectionConfig;
+}
+
+/** An inline sort item definition */
+declare interface InlineSortItem {
+    /**
+     * Name of the sorted field
+     * @maxLength 200
+     */
+    name?: string | null;
+    /**
+     * Human-readable name for this field
+     * @maxLength 100
+     */
+    displayName?: string | null;
+    /**
+     * Human-readable label for the ascending sort order of this field (e.g. "Oldest first")
+     * @maxLength 100
+     */
+    ascendingDisplayName?: string | null;
+    /**
+     * Human-readable label for the descending sort order of this field (e.g. "Newest first")
+     * @maxLength 100
+     */
+    descendingDisplayName?: string | null;
+    /**
+     * A description of this sort field
+     * @maxLength 300
+     */
+    description?: string | null;
+}
+
+declare enum InputTypeEnumInputType {
+    UNKNOWN_InputType = "UNKNOWN_InputType",
+    /** target.value (string) - Text inputs, selects, sliders, search boxes */
+    text = "text",
+    /** target.checked (boolean) - Checkboxes, toggles, switches */
+    checkbox = "checkbox",
+    /** target.valueAsNumber (number) - Number inputs, range inputs */
+    number = "number",
+    /** target.valueAsDate (Date) - Date pickers, datetime inputs */
+    date = "date"
 }
 
 declare interface InstallationInfo extends InstallationInfoTargetContainerOneOf {
@@ -2490,15 +3016,50 @@ declare enum InteractionsTrigger {
     animationEnd = "animationEnd"
 }
 
+declare enum ItemField {
+    /** item.id */
+    ID = "ID",
+    /** item.name */
+    NAME = "NAME",
+    /** item.description */
+    DESCRIPTION = "DESCRIPTION",
+    /** item.note */
+    NOTE = "NOTE"
+}
+
 /** A path to a data item within the same element scope. */
 declare interface ItemPath {
+    /**
+     * Deprecated, use item_key instead
+     * @deprecated Deprecated, use item_key instead
+     * @replacedBy item_key
+     * @targetRemovalDate 2026-09-30
+     */
+    dataItemKey?: string;
     /**
      * The key of the data item within the element's data scope.
      * Example: "items"        – top-level data item 'items'
      * Example: "slides.title" – inner key 'title' of data item 'slides'
      * @minLength 1
      */
-    dataItemKey?: string;
+    itemKey?: string;
+}
+
+/** Configuration for selecting items from an items provider (e.g. via a dropdown picker) */
+declare interface ItemSelectionConfig {
+    /**
+     * The key of the items provider to select items from
+     * @minLength 1
+     * @maxLength 100
+     */
+    providerKey?: string;
+    /**
+     * The maximum number of items that can be selected
+     * @min 1
+     */
+    maxSelected?: number | null;
+    /** The item field whose value is stored (defaults to id) */
+    itemField?: ItemField;
 }
 
 export declare interface ItemsGroup {
@@ -2530,6 +3091,14 @@ export declare interface Link {
      * @maxSize 12
      */
     linkTypes?: LinkType[];
+    /**
+     * Allows limiting the link to specific Wix apps, by their app ID, in case of LinkType dynamicPageLink or pageLink
+     * @format GUID
+     * @maxSize 20
+     */
+    appIds?: string[];
+    /** In case of LinkType dynamicPageLink, whether to hide inner routes in the page selection dialog (only top level pages will be selectable) */
+    hideInnerRoute?: boolean | null;
 }
 
 declare enum LinkType {
@@ -2682,6 +3251,11 @@ export declare interface PanelAction extends PanelActionSelectedPanelTypeOneOf {
     /* Excluded from this release type: inline */
     /** The selected panel reference type */
     panelType?: PanelType;
+    /**
+     * Optional hint. When used on a custom action the editor will handle it as if it was a native one.
+     * Will be ignored when used on native actions or when the value `custom` is selected.
+     */
+    actionName?: ACTION_NAME;
 }
 
 /** @oneof */
@@ -2743,6 +3317,71 @@ declare enum PanelType {
     inline = "inline"
 }
 
+declare interface PartContainer {
+    /**
+     * A CSS selector for an element inside the container part, wrapping container background content
+     * @minLength 4
+     * @maxLength 300
+     */
+    backgroundSelector?: string | null;
+    /**
+     * A CSS selector for an element inside the container part, wrapping container's contents
+     * @minLength 4
+     * @maxLength 300
+     */
+    contentSelector?: string | null;
+}
+
+declare interface PartElement extends PartElementSelectedPartElementTypeOneOf {
+    /** Media-specific selectors for parts of type media */
+    media?: PartMedia;
+    /** Container-specific selectors for parts of type container */
+    container?: PartContainer;
+    /** The type of the part element. */
+    partType?: PartType;
+    /**
+     * A CSS selector for the part element relative to its parent
+     * @minLength 4
+     * @maxLength 300
+     */
+    selector?: string;
+}
+
+/** @oneof */
+declare interface PartElementSelectedPartElementTypeOneOf {
+    /** Media-specific selectors for parts of type media */
+    media?: PartMedia;
+    /** Container-specific selectors for parts of type container */
+    container?: PartContainer;
+}
+
+declare interface PartMedia {
+    /**
+     * A CSS selector for an element wrapping the media layer element
+     * @minLength 4
+     * @maxLength 300
+     */
+    wrapperSelector?: string | null;
+    /**
+     * A CSS selector for an element wrapping the media wrapper element
+     * @minLength 4
+     * @maxLength 300
+     */
+    clipSelector?: string | null;
+}
+
+declare enum PartType {
+    UNKNOWN_PartType = "UNKNOWN_PartType",
+    /** An element containing text content */
+    text = "text",
+    /** An element containing SVG content */
+    svg = "svg",
+    /** An element containing media content (raster, image or video) */
+    media = "media",
+    /** An inner wrapper element for a container component */
+    container = "container"
+}
+
 declare interface PlaceHolder {
     /**
      * The placeholder definition that this container should accept as defined in DEV Center
@@ -2770,6 +3409,17 @@ declare interface PresetElementDefaults {
      * The Preset is the second in line to affect the display, Element is before and State is after it
      */
     displayFilters?: DisplayFilters_2;
+    /**
+     * A description of the element when this preset is selected
+     * @maxLength 300
+     */
+    description?: string | null;
+    /**
+     * Optional per-preset layout overrides for containers in this element's data scope, keyed by the container's data-item key.
+     * Each key must reference a data item of type 'container' in the same scope. Any field left unset on the
+     * ContainerLayout falls back to the container's own declared layout.
+     */
+    containers?: Record<string, ContainerLayout>;
 }
 
 declare interface PresetInnerElementDefaults {
@@ -2779,21 +3429,17 @@ declare interface PresetInnerElementDefaults {
     cssCustomProperties?: Record<string, CssPropertyItemDefaults>;
     /** The default preset and styles for inner elements */
     elements?: Record<string, PresetInnerElementDefaults>;
+    /**
+     * Optional per-preset layout overrides for containers in this element's data scope, keyed by the container's data-item key.
+     * Each key must reference a data item of type 'container' in this element's scope. Any field left unset on the
+     * ContainerLayout falls back to the container's own declared layout.
+     */
+    containers?: Record<string, ContainerLayout>;
 }
 
 export declare type PresetItem = PresetItem_2 & RequiredFields<PresetItem_2, 'displayName'>;
 
 declare interface PresetItem_2 {
-    /**
-     * DEPRECATED - use preset_css_url instead
-     * @format WEB_URL
-     * @minLength 13
-     * @maxLength 500
-     * @deprecated DEPRECATED - use preset_css_url instead
-     * @replacedBy preset_css_url
-     * @targetRemovalDate 2025-08-01
-     */
-    cssUrl?: string;
     /**
      * Preset name for displaying purposes in the editor
      * @maxLength 100
@@ -2807,22 +3453,6 @@ declare interface PresetItem_2 {
     thumbnailUrl?: string | null;
     /** Optional initial size of the component when switching into this preset (will not be applied when element is used as an inner element) */
     initialSize?: ComponentInitialSize;
-    /**
-     * Display filters for the Preset, used to define the visibility of inner / ref elements, style items, data items and custom actions in the editor
-     * The Preset is the second in line to affect the display, Element is before and State is after it
-     * @deprecated Display filters for the Preset, used to define the visibility of inner / ref elements, style items, data items and custom actions in the editor
-     * The Preset is the second in line to affect the display, Element is before and State is after it
-     * @replacedBy preset_defaults
-     * @targetRemovalDate 2025-08-01
-     */
-    displayFilters?: DisplayFilters_2;
-    /**
-     * The default styles for this preset and the inner elements
-     * @deprecated The default styles for this preset and the inner elements
-     * @replacedBy preset_defaults
-     * @targetRemovalDate 2025-08-01
-     */
-    styleDefaults?: PresetStyleDefaults;
     /** The style overrides for this preset and the inner elements */
     styleOverrides?: BreakpointPresetStyleOverrides;
     /**
@@ -2832,13 +3462,6 @@ declare interface PresetItem_2 {
      * @maxSize 2
      */
     optimizedFor?: BreakpointEnumBreakpoint[];
-    /**
-     * Optional editor layout behaviors we want to apply when this preset is selected
-     * @deprecated Optional editor layout behaviors we want to apply when this preset is selected
-     * @replacedBy preset_defaults
-     * @targetRemovalDate 2025-08-01
-     */
-    layout?: EditorElementLayout;
     /**
      * A URL to the CSS file of this preset, to be used when you need to apply many css-changes or default-values to the DOM when this preset is selected, optional
      * @format WEB_URL
@@ -2847,18 +3470,16 @@ declare interface PresetItem_2 {
     presetCssUrl?: string | null;
     /** All the default values that needs to be set when the preset is selected */
     presetDefaults?: PresetElementDefaults;
+    /* Excluded from this release type: spec */
+    /**
+     * A description of this preset
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 export declare type Presets = NonNullable<EditorElement_2['presets']>;
 
-/** DEPRECATED: This message is deprecated and will be removed in the future */
-declare interface PresetStyleDefaults {
-    /** The default styles for this preset */
-    style?: Record<string, StyleItemDefaults>;
-    /** The default styles of inner elements for this preset */
-    elements?: Record<string, ElementStyleDefaults>;
-}
-
 declare interface PresetStyleItemOverrides {
     /** The override value of this style item */
     value?: any;
@@ -2867,13 +3488,6 @@ declare interface PresetStyleItemOverrides {
 }
 
 declare interface PresetStyleOverrides {
-    /**
-     * The style overrides for this preset
-     * @deprecated The style overrides for this preset
-     * @replacedBy cssProperties or cssCustomProperties
-     * @targetRemovalDate 2025-08-01
-     */
-    style?: Record<string, PresetStyleItemOverrides>;
     /** The style overrides of inner elements for this preset */
     elements?: Record<string, ElementStyleOverrides>;
     /** The default values for the element css-properties when the preset is selected */
@@ -2897,12 +3511,25 @@ declare interface ReactElementContainer extends ReactElementContainerSelectedCon
     template?: TemplateContainer;
     /**
      * A DOM Selector that will allow us to target it in the editor
-     * @minLength 2
      * @maxLength 100
+     * @deprecated A DOM Selector that will allow us to target it in the editor
+     * @targetRemovalDate 2026-05-31
      */
     selector?: string;
     /** The type of Container to be rendered */
     containerType?: CONTAINER_TYPE;
+    /** Contexts available in this container */
+    contexts?: ContextReferences;
+    /**
+     * An optional override of the display name of the container.
+     * @maxLength 50
+     */
+    displayName?: string | null;
+    /**
+     * An optional override of the description of the container
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 /** @oneof */
@@ -2962,6 +3589,11 @@ export declare interface RefElement {
     cssCustomProperties?: Record<string, CssPropertyItemDefinitionOverrides>;
     /** A reference to a help article for this element */
     helpArticle?: HelpArticle;
+    /**
+     * The override of the used element description
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 declare interface RefInnerElementDefaults {
@@ -3022,6 +3654,8 @@ declare interface Resources {
     /* Excluded from this release type: viewerReducedModel */
     /* Excluded from this release type: schemaRefsUrl */
     /* Excluded from this release type: viewerRuntimeCss */
+    /** The exported hooks for usage with the contexts defined inside the editorElement. key must ,match key in the contexts map of the editorElement, and the value is the name of the hook that will be used to consume this context in the component code. Example: { "MyContext": "useMyContext" } */
+    contextHooks?: Record<string, string>;
 }
 
 /** rich text data type allow manipulation of text with html & inline styles */
@@ -3145,6 +3779,9 @@ declare interface SimpleContainer {
     /**
      * An optional override of the display name of the container.
      * @maxLength 50
+     * @deprecated
+     * @replacedBy container.display_name
+     * @targetRemovalDate 2026-06-30
      */
     displayName?: string | null;
 }
@@ -3159,6 +3796,63 @@ declare enum SizingType {
     pixels = "pixels"
 }
 
+/** Sort type - declares which items are available for sorting */
+declare interface SortDefinition {
+    /** Fully described inline sort items */
+    inlineItems?: InlineSortItem[];
+    /** Sort items referencing existing data items */
+    dataItems?: SortItem[];
+    /** Sort items referencing existing context items */
+    contextItems?: SortItem[];
+}
+
+/**
+ * A sort item referencing an existing item (e.g. DataItem or ContextItem),
+ * with optional per-direction display labels.
+ */
+declare interface SortItem {
+    /** Path to the item */
+    itemPath?: ItemPath;
+    /**
+     * Human-readable label for the ascending sort order of this item (e.g. "Oldest first")
+     * @maxLength 100
+     */
+    ascendingDisplayName?: string | null;
+    /**
+     * Human-readable label for the descending sort order of this item (e.g. "Newest first")
+     * @maxLength 100
+     */
+    descendingDisplayName?: string | null;
+}
+
+/** The value the context applies to a context item in a given preview state */
+declare interface StateContextItem extends StateContextItemValueOneOf {
+    /** The boolean the context applies to a booleanValue context item */
+    booleanValue?: boolean | null;
+    /**
+     * The TextEnum.Option.value the context applies to a textEnum context item
+     * @maxLength 100
+     */
+    enumValue?: string | null;
+    /**
+     * Key of the context.items entry this value applies to. Must reference an existing item whose
+     * data_type is booleanValue or textEnum
+     * @maxLength 100
+     */
+    itemKey?: string | null;
+}
+
+/** @oneof */
+declare interface StateContextItemValueOneOf {
+    /** The boolean the context applies to a booleanValue context item */
+    booleanValue?: boolean | null;
+    /**
+     * The TextEnum.Option.value the context applies to a textEnum context item
+     * @maxLength 100
+     */
+    enumValue?: string | null;
+}
+
 export declare type States = NonNullable<EditorElement_2['states']>;
 
 declare enum StaticContainer {
@@ -3169,6 +3863,24 @@ declare enum StaticContainer {
     GLOBAL_PAGE = "GLOBAL_PAGE"
 }
 
+declare interface StrokeGroup {
+    /**
+     * Stores the stroke property of the stroke group
+     * @maxLength 100
+     */
+    stroke?: string | null;
+    /**
+     * Stores the stroke-width property of the stroke group
+     * @maxLength 100
+     */
+    strokeWidth?: string | null;
+    /**
+     * Stores the stroke-opacity property of the stroke group
+     * @maxLength 100
+     */
+    strokeOpacity?: string | null;
+}
+
 /** DEPRECATED - use CssPropertyAction or CssCustomPropertyAction */
 declare interface StyleAction {
     /**
@@ -3235,14 +3947,6 @@ export declare interface StyleItem extends StyleItemSelectedItemTypeOneOf, Style
     /* Excluded from this release type: deprecated */
 }
 
-/** DEPRECATED: This message is deprecated and will be removed in the future */
-declare interface StyleItemDefaults {
-    /** The default value of this style item */
-    defaultValue?: any;
-    /** The default values for the style-item when the component is in one of the defined states */
-    statesDefaultValues?: Record<string, any>;
-}
-
 /** DEPRECATED: This message is deprecated and will be removed in the future */
 declare interface StyleItemOverrides {
     /** Disables the ability to edit this style-item */
@@ -3461,6 +4165,11 @@ declare interface Text_2 {
      * @maxLength 100
      */
     pattern?: string | null;
+    /**
+     * Configures this text as an item-selection field, populated by an items provider implementing the Items
+     * Selection SPI (wix.items_selection.spi_host.v1). provider_key picks the provider; for multi-select use an array of Text.
+     */
+    itemSelection?: ItemSelectionConfig;
 }
 export { Text_2 as Text }
 
@@ -3511,6 +4220,11 @@ declare interface TextEnumOption {
      * @maxLength 100
      */
     displayName?: string;
+    /**
+     * A description of this text item
+     * @maxLength 300
+     */
+    description?: string | null;
 }
 
 export declare interface TextGroup {