@xsolla/xui-multi-select 0.216.0 → 0.217.0

package/web/index.d.mts

@@ -11,6 +11,19 @@ interface MultiSelectOption {
     label: ReactNode;
     value: string | number;
     disabled?: boolean;
+    /**
+     * When `false`, this option is **locked**: once selected it cannot be
+     * removed. Its tag renders without a remove button, clicking the tag does
+     * nothing, toggling the option off in the dropdown is a no-op, the
+     * `extraClear` clear-all button leaves it in place, and select-all /
+     * deselect-all skips it.
+     *
+     * Unlike `disabled`, a locked option is **not** greyed out — use it for a
+     * required, default-selected value (e.g. a base language that must always
+     * stay selected) that should still look like a normal selection.
+     * @default true
+     */
+    removable?: boolean;
 }
 interface MultiSelectProps extends ThemeOverrideProps {
     /**
@@ -70,12 +83,14 @@ interface MultiSelectProps extends ThemeOverrideProps {
      */
     flexible?: boolean;
     /**
-     * Switch on displaying a remove button in each tag.
+     * Switch on displaying a remove button in each tag. This is the
+     * component-wide default; an individual option can opt out with
+     * `MultiSelectOption.removable: false`.
      * @default true
      */
     removeTagsButtons?: boolean;
     /**
-     * Add clear all button.
+     * Add clear all button. Options with `removable: false` are kept.
      * @default false
      */
     extraClear?: boolean;
@@ -113,6 +128,32 @@ interface MultiSelectProps extends ThemeOverrideProps {
      * @default "No results"
      */
     noOptionsMessage?: string;
+    /**
+     * When true, shows a select-all / deselect-all row at the top of the
+     * built-in dropdown (below the search input when `searchable`).
+     *
+     * Scope is **the options currently listed**: with `searchable` active and a
+     * search query typed, it applies only to the filtered options, matching what
+     * the user can see. Options with `disabled: true` are skipped, and options
+     * with `removable: false` are never deselected. The row flips to
+     * deselect-all once every selectable listed option is selected.
+     *
+     * Ignored when `dropdownMenu` is false.
+     * @default false
+     */
+    selectAll?: boolean;
+    /**
+     * Label of the select-all row. Only used when `selectAll` is true.
+     * @default "Select all"
+     */
+    selectAllLabel?: string;
+    /**
+     * Label of the select-all row once everything listed is selected, at which
+     * point activating it clears the listed selection. Only used when
+     * `selectAll` is true.
+     * @default "Deselect all"
+     */
+    deselectAllLabel?: string;
     /**
      * When false, the built-in options list and backdrop are not shown and the control
      * does not open on click. Use with an external picker (e.g. grouped select) wired

package/web/index.d.ts

@@ -11,6 +11,19 @@ interface MultiSelectOption {
     label: ReactNode;
     value: string | number;
     disabled?: boolean;
+    /**
+     * When `false`, this option is **locked**: once selected it cannot be
+     * removed. Its tag renders without a remove button, clicking the tag does
+     * nothing, toggling the option off in the dropdown is a no-op, the
+     * `extraClear` clear-all button leaves it in place, and select-all /
+     * deselect-all skips it.
+     *
+     * Unlike `disabled`, a locked option is **not** greyed out — use it for a
+     * required, default-selected value (e.g. a base language that must always
+     * stay selected) that should still look like a normal selection.
+     * @default true
+     */
+    removable?: boolean;
 }
 interface MultiSelectProps extends ThemeOverrideProps {
     /**
@@ -70,12 +83,14 @@ interface MultiSelectProps extends ThemeOverrideProps {
      */
     flexible?: boolean;
     /**
-     * Switch on displaying a remove button in each tag.
+     * Switch on displaying a remove button in each tag. This is the
+     * component-wide default; an individual option can opt out with
+     * `MultiSelectOption.removable: false`.
      * @default true
      */
     removeTagsButtons?: boolean;
     /**
-     * Add clear all button.
+     * Add clear all button. Options with `removable: false` are kept.
      * @default false
      */
     extraClear?: boolean;
@@ -113,6 +128,32 @@ interface MultiSelectProps extends ThemeOverrideProps {
      * @default "No results"
      */
     noOptionsMessage?: string;
+    /**
+     * When true, shows a select-all / deselect-all row at the top of the
+     * built-in dropdown (below the search input when `searchable`).
+     *
+     * Scope is **the options currently listed**: with `searchable` active and a
+     * search query typed, it applies only to the filtered options, matching what
+     * the user can see. Options with `disabled: true` are skipped, and options
+     * with `removable: false` are never deselected. The row flips to
+     * deselect-all once every selectable listed option is selected.
+     *
+     * Ignored when `dropdownMenu` is false.
+     * @default false
+     */
+    selectAll?: boolean;
+    /**
+     * Label of the select-all row. Only used when `selectAll` is true.
+     * @default "Select all"
+     */
+    selectAllLabel?: string;
+    /**
+     * Label of the select-all row once everything listed is selected, at which
+     * point activating it clears the listed selection. Only used when
+     * `selectAll` is true.
+     * @default "Deselect all"
+     */
+    deselectAllLabel?: string;
     /**
      * When false, the built-in options list and backdrop are not shown and the control
      * does not open on click. Use with an external picker (e.g. grouped select) wired