@microsoft/sp-module-interfaces 1.22.1 → 1.23.0-beta.0

package/dist/index-internal-beta.d.ts

@@ -949,9 +949,10 @@ export declare interface ICommandDefinition {
     title: ILocalizedString;
     /**
      * Type of the item.
-     * Currently only "command" is allowed.
+     * - 'command': A standard executable command
+     * - 'group': A group that contains child commands (renders as submenu)
      */
-    type: 'command';
+    type: 'command' | 'group';
     /**
      * Custom accessibility text for the browser's "aria-label" attribute.  If omitted, the title property
      * will be used by default.
@@ -968,8 +969,25 @@ export declare interface ICommandDefinition {
      * the folder containing the input manifest. The icon file will be copied to the deployment folder like an asset,
      * and the output manifest's iconImageUrl will be replaced with a URL relative to the URL used to load all other
      * assets (the loaderConfig.internalModuleBaseUrls property).
+     *
+     * For groups, this icon is displayed on the parent button.
      */
     iconImageUrl?: string;
+    /**
+     * Optional ID of the parent group this command/group belongs to.
+     * Used to build hierarchical command structures where commands appear in submenus.
+     *
+     * @remarks
+     * - Must reference a valid group item ID defined in the same manifest
+     * - Both commands and groups can have a group property (for nested groups)
+     * - Maximum nesting depth is 2 levels, where a top-level group can contain one additional nested group
+     * - Child commands are displayed in manifest definition order within their group
+     * - If the parent group ID is not found, the command appears at top level
+     * - Groups are automatically hidden if all their children are invisible
+     *
+     * Example: "EXPORT_GROUP" (where EXPORT_GROUP is defined as type: 'group')
+     */
+    group?: string;
 }
 
 /**

package/dist/index-internal-public.d.ts

@@ -541,9 +541,10 @@ export declare interface ICommandDefinition {
     title: ILocalizedString;
     /**
      * Type of the item.
-     * Currently only "command" is allowed.
+     * - 'command': A standard executable command
+     * - 'group': A group that contains child commands (renders as submenu)
      */
-    type: 'command';
+    type: 'command' | 'group';
     /**
      * Custom accessibility text for the browser's "aria-label" attribute.  If omitted, the title property
      * will be used by default.
@@ -560,8 +561,25 @@ export declare interface ICommandDefinition {
      * the folder containing the input manifest. The icon file will be copied to the deployment folder like an asset,
      * and the output manifest's iconImageUrl will be replaced with a URL relative to the URL used to load all other
      * assets (the loaderConfig.internalModuleBaseUrls property).
+     *
+     * For groups, this icon is displayed on the parent button.
      */
     iconImageUrl?: string;
+    /**
+     * Optional ID of the parent group this command/group belongs to.
+     * Used to build hierarchical command structures where commands appear in submenus.
+     *
+     * @remarks
+     * - Must reference a valid group item ID defined in the same manifest
+     * - Both commands and groups can have a group property (for nested groups)
+     * - Maximum nesting depth is 2 levels, where a top-level group can contain one additional nested group
+     * - Child commands are displayed in manifest definition order within their group
+     * - If the parent group ID is not found, the command appears at top level
+     * - Groups are automatically hidden if all their children are invisible
+     *
+     * Example: "EXPORT_GROUP" (where EXPORT_GROUP is defined as type: 'group')
+     */
+    group?: string;
 }
 
 /**