@microsoft/sp-module-interfaces 1.22.0-beta.1 → 1.22.0-beta.3

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

@@ -265,6 +265,8 @@ export declare interface IAdaptiveCardExtensionManifestEntry<TProperties> {
     properties: TProperties;
 }
 
+/* Excluded from this release type: IAIProperties */
+
 /* Excluded from this release type: ICapabilityCollection */
 
 /* Excluded from this release type: IClientSideApplicationManifest */
@@ -658,6 +660,7 @@ export declare interface IClientSideWebPartManifest<TProperties> extends IClient
      */
     supportsThemeVariants?: boolean;
     /* Excluded from this release type: useFallbackWhenPropertiesUpdatedExternally */
+    /* Excluded from this release type: idleLoadComponents */
     /**
      * A Web Part can have pre-configured properties like the title, description, toolbox group name and Web
      * Part specific custom properties. And there can be multiple instances of these pre-configured properties.
@@ -748,6 +751,7 @@ export declare interface IClientSideWebPartManifest<TProperties> extends IClient
      * Ensure this remains up to date with IFlexibleControlSizingData in FlexibleControl.types.ts
      */
     flexibleLayoutSizing?: IFlexibleLayoutSizing;
+    /* Excluded from this release type: aiProperties */
 }
 
 /**
@@ -1004,6 +1008,8 @@ export declare interface ICommandSetExtensionManifest extends IClientSideExtensi
     };
 }
 
+/* Excluded from this release type: _IComponentFallbackVersion */
+
 /**
  * This is the interface for a script module with the "component" type. Modules of this type will be provided via
  * manifests. In order for the dependency to be loaded, the manifest must be available on the site.
@@ -1048,6 +1054,7 @@ export declare interface IComponentModuleConfiguration extends IModuleConfigurat
      * Example: `"https://code.jquery.com/jquery-2.2.4.min.js"`
      */
     failoverPath?: string | IIntegrityPath;
+    /* Excluded from this release type: fallbackVersion */
 }
 
 /**
@@ -1070,6 +1077,12 @@ export declare interface IFlexibleLayoutSizing {
     defaultRowHeight?: number;
 }
 
+/* Excluded from this release type: _IFlightedComponent */
+
+/* Excluded from this release type: _IFlightOrKillSwitch */
+
+/* Excluded from this release type: _IIdleLoadComponent */
+
 /**
  * A path with the subresource integrity hash of the resource.
  *
@@ -1086,6 +1099,8 @@ export declare interface IIntegrityPath {
     integrity?: string;
 }
 
+/* Excluded from this release type: _IKillSwitchComponent */
+
 /**
  * This is the interface for a script module with the "localizedPath" type.
  *
@@ -1231,6 +1246,8 @@ export declare interface IModuleConfigurationBase {
     shouldNotPreload?: boolean;
 }
 
+/* Excluded from this release type: _IOperatorOrSwitch */
+
 /**
  * This is the interface for a script module with the "path" type. Modules of this type must be provided by the
  * component developer.

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

@@ -15,6 +15,8 @@ export declare type ExtensionType = 'Unknown' | 'ApplicationCustomizer' | 'Field
 
 /* Excluded from this release type: IAdaptiveCardExtensionManifestEntry */
 
+/* Excluded from this release type: IAIProperties */
+
 /* Excluded from this release type: ICapabilityCollection */
 
 /* Excluded from this release type: IClientSideApplicationManifest */
@@ -283,6 +285,7 @@ export declare interface IClientSideWebPartManifest<TProperties> extends IClient
      */
     supportsThemeVariants?: boolean;
     /* Excluded from this release type: useFallbackWhenPropertiesUpdatedExternally */
+    /* Excluded from this release type: idleLoadComponents */
     /**
      * A Web Part can have pre-configured properties like the title, description, toolbox group name and Web
      * Part specific custom properties. And there can be multiple instances of these pre-configured properties.
@@ -373,6 +376,7 @@ export declare interface IClientSideWebPartManifest<TProperties> extends IClient
      * Ensure this remains up to date with IFlexibleControlSizingData in FlexibleControl.types.ts
      */
     flexibleLayoutSizing?: IFlexibleLayoutSizing;
+    /* Excluded from this release type: aiProperties */
 }
 
 /**
@@ -596,6 +600,8 @@ export declare interface ICommandSetExtensionManifest extends IClientSideExtensi
     };
 }
 
+/* Excluded from this release type: _IComponentFallbackVersion */
+
 /* Excluded from this release type: IComponentModuleConfiguration */
 
 /**
@@ -618,8 +624,16 @@ export declare interface IFlexibleLayoutSizing {
     defaultRowHeight?: number;
 }
 
+/* Excluded from this release type: _IFlightedComponent */
+
+/* Excluded from this release type: _IFlightOrKillSwitch */
+
+/* Excluded from this release type: _IIdleLoadComponent */
+
 /* Excluded from this release type: IIntegrityPath */
 
+/* Excluded from this release type: _IKillSwitchComponent */
+
 /* Excluded from this release type: ILocalizedPathModuleConfiguration */
 
 /**
@@ -672,6 +686,8 @@ export declare interface ILocalizedString {
 
 /* Excluded from this release type: IModuleConfigurationBase */
 
+/* Excluded from this release type: _IOperatorOrSwitch */
+
 /* Excluded from this release type: IPathModuleConfiguration */
 
 /* Excluded from this release type: IPrefabAppManifest */

package/dist/index-internal.d.ts

@@ -265,6 +265,8 @@ export declare interface IAdaptiveCardExtensionManifestEntry<TProperties> {
     properties: TProperties;
 }
 
+/* Excluded from this release type: IAIProperties */
+
 /* Excluded from this release type: ICapabilityCollection */
 
 /* Excluded from this release type: IClientSideApplicationManifest */
@@ -658,6 +660,7 @@ export declare interface IClientSideWebPartManifest<TProperties> extends IClient
      */
     supportsThemeVariants?: boolean;
     /* Excluded from this release type: useFallbackWhenPropertiesUpdatedExternally */
+    /* Excluded from this release type: idleLoadComponents */
     /**
      * A Web Part can have pre-configured properties like the title, description, toolbox group name and Web
      * Part specific custom properties. And there can be multiple instances of these pre-configured properties.
@@ -748,6 +751,7 @@ export declare interface IClientSideWebPartManifest<TProperties> extends IClient
      * Ensure this remains up to date with IFlexibleControlSizingData in FlexibleControl.types.ts
      */
     flexibleLayoutSizing?: IFlexibleLayoutSizing;
+    /* Excluded from this release type: aiProperties */
 }
 
 /**
@@ -1004,6 +1008,8 @@ export declare interface ICommandSetExtensionManifest extends IClientSideExtensi
     };
 }
 
+/* Excluded from this release type: _IComponentFallbackVersion */
+
 /**
  * This is the interface for a script module with the "component" type. Modules of this type will be provided via
  * manifests. In order for the dependency to be loaded, the manifest must be available on the site.
@@ -1048,6 +1054,7 @@ export declare interface IComponentModuleConfiguration extends IModuleConfigurat
      * Example: `"https://code.jquery.com/jquery-2.2.4.min.js"`
      */
     failoverPath?: string | IIntegrityPath;
+    /* Excluded from this release type: fallbackVersion */
 }
 
 /**
@@ -1070,6 +1077,12 @@ export declare interface IFlexibleLayoutSizing {
     defaultRowHeight?: number;
 }
 
+/* Excluded from this release type: _IFlightedComponent */
+
+/* Excluded from this release type: _IFlightOrKillSwitch */
+
+/* Excluded from this release type: _IIdleLoadComponent */
+
 /**
  * A path with the subresource integrity hash of the resource.
  *
@@ -1086,6 +1099,8 @@ export declare interface IIntegrityPath {
     integrity?: string;
 }
 
+/* Excluded from this release type: _IKillSwitchComponent */
+
 /**
  * This is the interface for a script module with the "localizedPath" type.
  *
@@ -1231,6 +1246,8 @@ export declare interface IModuleConfigurationBase {
     shouldNotPreload?: boolean;
 }
 
+/* Excluded from this release type: _IOperatorOrSwitch */
+
 /**
  * This is the interface for a script module with the "path" type. Modules of this type must be provided by the
  * component developer.

package/lib-commonjs/index.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 _export_star(require("./manifestSchemas/IClientSideApplicationManifest"), exports);
 _export_star(require("./manifestSchemas/IClientSideAssemblyManifest"), exports);
-_export_star(require("./manifestSchemas/IClientSideComponentLoaderConfiguration"), exports);
 _export_star(require("./manifestSchemas/IClientSideComponentManifest"), exports);
 _export_star(require("./manifestSchemas/IClientSideExtensionManifest"), exports);
 _export_star(require("./manifestSchemas/IClientSideLibraryManifest"), exports);

package/lib-commonjs/manifestSchemas/examples/webpart.manifest.json

@@ -323,6 +323,68 @@
         "path": "nonAmdB.js",
         "globalName": "nonAmdB",
         "globalDependencies": ["nonAmdB"]
+      },
+      "fallbackFlighted": {
+        "type": "component",
+        "version": "1.2.3",
+        "id": "00000000-0000-0000-0000-000000000000",
+        "fallbackVersion": {
+          "version": "0.0.1",
+          "condition": {
+            "switchType": "flight",
+            "id": 12345
+          }
+        }
+      },
+      "fallbackKillSwitched": {
+        "type": "component",
+        "version": "1.2.3",
+        "id": "00000000-0000-0000-0000-000000000000",
+        "fallbackVersion": {
+          "version": "0.0.1",
+          "condition": {
+            "switchType": "killswitch",
+            "id": "00000000-0000-0000-0000-000000000000"
+          }
+        }
+      },
+      "fallbackComplexExpression": {
+        "type": "component",
+        "version": "1.2.3",
+        "id": "00000000-0000-0000-0000-000000000000",
+        "fallbackVersion": {
+          "version": "0.0.1",
+          "condition": {
+            "xor": [
+              {
+                "or": [
+                  {
+                    "switchType": "flight",
+                    "id": 12345
+                  },
+                  {
+                    "not": {
+                      "switchType": "killswitch",
+                      "id": "00000000-0000-0000-0000-000000000000"
+                    }
+                  }
+                ]
+              },
+              {
+                "and": [
+                  {
+                    "switchType": "flight",
+                    "id": 67890
+                  },
+                  {
+                    "switchType": "killswitch",
+                    "id": "11111111-1111-1111-1111-111111111111"
+                  }
+                ]
+              }
+            ]
+          }
+        }
       }
     }
   },

package/lib-commonjs/manifestSchemas/examples/webpart_1.manifest.js

@@ -338,6 +338,68 @@ const webpartManifest = {
                 globalDependencies: [
                     'nonAmdB'
                 ]
+            },
+            fallbackFlighted: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'flight',
+                        id: 12345
+                    }
+                }
+            },
+            fallbackKillSwitched: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'killswitch',
+                        id: '00000000-0000-0000-0000-000000000000'
+                    }
+                }
+            },
+            fallbackComplexExpression: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        xor: [
+                            {
+                                or: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 12345
+                                    },
+                                    {
+                                        not: {
+                                            switchType: 'killswitch',
+                                            id: '00000000-0000-0000-0000-000000000000'
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                and: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 67890
+                                    },
+                                    {
+                                        switchType: 'killswitch',
+                                        id: '11111111-1111-1111-1111-111111111111'
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                }
             }
         }
     },

package/lib-commonjs/manifestSchemas/examples/webpart_2.manifest.js

@@ -337,6 +337,68 @@ const webpartManifest = {
                 globalDependencies: [
                     'nonAmdB'
                 ]
+            },
+            fallbackFlighted: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'flight',
+                        id: 12345
+                    }
+                }
+            },
+            fallbackKillSwitched: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'killswitch',
+                        id: '00000000-0000-0000-0000-000000000000'
+                    }
+                }
+            },
+            fallbackComplexExpression: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        xor: [
+                            {
+                                or: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 12345
+                                    },
+                                    {
+                                        not: {
+                                            switchType: 'killswitch',
+                                            id: '00000000-0000-0000-0000-000000000000'
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                and: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 67890
+                                    },
+                                    {
+                                        switchType: 'killswitch',
+                                        id: '11111111-1111-1111-1111-111111111111'
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                }
             }
         }
     },

package/lib-commonjs/manifestSchemas/jsonSchemas/client-side-component-loader-configuration.schema.json

@@ -105,7 +105,8 @@
                         "shouldNotPreload": { "$ref": "any-value.schema.json" },
                         "version": { "$ref": "any-value.schema.json" },
                         "id": { "$ref": "any-value.schema.json" },
-                        "failoverPath": { "$ref": "any-value.schema.json" }
+                        "failoverPath": { "$ref": "any-value.schema.json" },
+                        "fallbackVersion": { "$ref": "any-value.schema.json" }
                       },
                       "additionalProperties": false
                     },
@@ -145,6 +146,10 @@
                           "title": "Failover Path",
                           "description": "A path to the framework-supplied module in case the framework fails to load the requested version. This must be either a fully-qualified URL, or a path under the paths specified in the \"internalModuleBaseUrls\" field. If this field is not specified and the version is not available in the framework runtime, the closest matching version of the module will be provided instead.",
                           "$ref": "#/definitions/path"
+                        },
+
+                        "fallbackVersion": {
+                          "$ref": "component-fallback-version.schema.json"
                         }
                       },
                       "additionalProperties": true

package/lib-commonjs/manifestSchemas/jsonSchemas/client-side-web-part-manifest.schema.json

@@ -166,6 +166,65 @@
             }
           },
           "additionalProperties": false
+        },
+        "idleLoadComponents": {
+          "description": "A list of components that can be loaded on idle for performance optimization. These components generally used to support rendering the web part.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "displayMode": {
+                "type": "string",
+                "enum": ["edit", "read"]
+              },
+              "priority": {
+                "type": "string",
+                "enum": ["high", "low"]
+              },
+              "componentId": {
+                "type": "string"
+              }
+            },
+            "required": ["priority", "componentId"]
+          }
+        },
+        "aiProperties": {
+          "type": "object",
+          "title": "References to AI properties and mapping definitions.",
+          "description": "Supports definition of web part AI properties and its mapping with existing property bag",
+          "required": ["structure", "mapping"],
+          "properties": {
+            "structure": {
+              "type": "object",
+              "title": "AI properties structure",
+              "description": "The structure of AI properties for the web part.",
+              "additionalProperties": false,
+              "required": ["id"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The identifier for the AI properties structure.",
+                  "pattern": "^\\$[^:]+:.+;$"
+                }
+              }
+            },
+            "mapping": {
+              "type": "object",
+              "title": "AI properties mapping",
+              "description": "The mapping of AI properties to existing property bag.",
+              "additionalProperties": false,
+              "required": ["id"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The identifier for the AI properties mapping.",
+                  "pattern": "^\\$[^:]+:.+;$"
+                }
+              }
+            }
+          },
+          "additionalProperties": false
         }
       },
       "additionalProperties": false

package/lib-commonjs/manifestSchemas/jsonSchemas/component-fallback-version.schema.json

@@ -0,0 +1,106 @@
+{
+  "id": "component-fallback-version.schema.json",
+  "title": "Component Fallback Version",
+  "description": "Represents a fallback version of a component that can be used under certain logical conditions, including flight and killswitch checks.",
+  "type": "object",
+  "required": ["version", "condition"],
+  "properties": {
+    "version": {
+      "description": "The version of the component to be used as a fallback.",
+      "oneOf": [{ "$ref": "semver.schema.json" }]
+    },
+    "condition": {
+      "description": "The condition under which the fallback version should be used. Supports logical operators and flight/killswitch checks.",
+      "$ref": "#/definitions/operatorOrSwitch"
+    }
+  },
+  "definitions": {
+    "operatorOrSwitch": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["and"],
+          "properties": {
+            "and": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/definitions/operatorOrSwitch" }
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["or"],
+          "properties": {
+            "or": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/definitions/operatorOrSwitch" }
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["xor"],
+          "properties": {
+            "xor": {
+              "type": "array",
+              "minItems": 2,
+              "maxItems": 2,
+              "items": { "$ref": "#/definitions/operatorOrSwitch" }
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["not"],
+          "properties": {
+            "not": { "$ref": "#/definitions/operatorOrSwitch" }
+          },
+          "additionalProperties": false
+        },
+        { "$ref": "#/definitions/flightOrKillSwitch" }
+      ]
+    },
+    "flightOrKillSwitch": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["switchType", "id"],
+          "properties": {
+            "switchType": {
+              "type": "string",
+              "enum": ["flight"],
+              "description": "Indicates this is a flight check."
+            },
+            "id": {
+              "type": "integer",
+              "description": "The numeric ID of the flight."
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["switchType", "id"],
+          "properties": {
+            "switchType": {
+              "type": "string",
+              "enum": ["killswitch"],
+              "description": "Indicates this is a killswitch check."
+            },
+            "id": {
+              "$ref": "guid.schema.json",
+              "description": "The GUID of the killswitch."
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/lib-dts/index.d.ts

@@ -1,6 +1,6 @@
 export * from './manifestSchemas/IClientSideApplicationManifest';
 export * from './manifestSchemas/IClientSideAssemblyManifest';
-export * from './manifestSchemas/IClientSideComponentLoaderConfiguration';
+export type { IClientSideComponentLoaderConfiguration, IModuleConfiguration, IIntegrityPath, IModuleConfigurationBase, IComponentModuleConfiguration, IPathModuleConfiguration, ILocalizedPathModuleConfiguration, IComponentFallbackVersion as _IComponentFallbackVersion, IOperatorOrSwitch as _IOperatorOrSwitch, IFlightOrKillSwitch as _IFlightOrKillSwitch, IFlightedComponent as _IFlightedComponent, IKillSwitchComponent as _IKillSwitchComponent } from './manifestSchemas/IClientSideComponentLoaderConfiguration';
 export * from './manifestSchemas/IClientSideComponentManifest';
 export * from './manifestSchemas/IClientSideExtensionManifest';
 export * from './manifestSchemas/IClientSideLibraryManifest';

package/lib-dts/manifestSchemas/IClientSideComponentLoaderConfiguration.d.ts

@@ -211,6 +211,82 @@ export interface IComponentModuleConfiguration extends IModuleConfigurationBase
      * Example: `"https://code.jquery.com/jquery-2.2.4.min.js"`
      */
     failoverPath?: string | IIntegrityPath;
+    /**
+     * Used to specify an alternative version of the dependency to be used, under certain conditions.
+     * @internal
+     */
+    fallbackVersion?: IComponentFallbackVersion;
+}
+/**
+ * @internal
+ * Represents a fallback version of a component that can be used under certain conditions.
+ *
+ * @remarks
+ * This field is used to specify an alternative version of the dependency to load, provided certain conditions are met.
+ * The conditions are specified using the `condition` field, which allows an expression to be defined. This supports the following:
+ *   - AND
+ *   - OR
+ *   - NOT
+ *   - XOR
+ *   - Flight checks
+ *   - Killswitch checks
+ *
+ * This field should only be used if the component has a multi-version manifest.
+ */
+export interface IComponentFallbackVersion {
+    /**
+     * @internal
+     * The version of the component to be used as a fallback.
+     *
+     * @remarks
+     * This should be a string representing a semantic version.
+     */
+    version: string;
+    /**
+     * @internal
+     * The condition under which the fallback version should be used.
+     *
+     * @remarks
+     * This condition is expressed as a logical operator or switch, which can include AND, OR, NOT, XOR,
+     * Flight checks, and KillSwitch checks. The condition must evaluate to true for the fallback version to be used.
+     */
+    condition: IOperatorOrSwitch;
+}
+/**
+ * @internal
+ * Represents the logical operators used in the flighted manifest configuration.
+ */
+export type IOperatorOrSwitch = {
+    and: IOperatorOrSwitch[];
+} | {
+    or: IOperatorOrSwitch[];
+} | {
+    xor: [IOperatorOrSwitch, IOperatorOrSwitch];
+} | {
+    not: IOperatorOrSwitch;
+} | IFlightOrKillSwitch;
+/**
+ * @internal
+ * Represents a flighted component or a kill switch component.
+ * This type is used to define components that can be toggled on or off
+ * based on certain conditions in the configuration.
+ */
+export type IFlightOrKillSwitch = IFlightedComponent | IKillSwitchComponent;
+/**
+ * @internal
+ * Represents a Flight check definition.
+ */
+export interface IFlightedComponent {
+    switchType: 'flight';
+    id: number;
+}
+/**
+ * @internal
+ * Represents a Kill Switch check definition.
+ */
+export interface IKillSwitchComponent {
+    switchType: 'killswitch';
+    id: string;
 }
 /**
  * This is the interface for a script module with the "path" type. Modules of this type must be provided by the

package/lib-dts/manifestSchemas/IClientSideWebPartManifest.d.ts

@@ -109,6 +109,26 @@ export interface IClientSideWebPartManifest<TProperties> extends IClientSideComp
      * logic, then it is recommended to override onAfterPropertiesUpdatedExternally.
      */
     useFallbackWhenPropertiesUpdatedExternally?: boolean;
+    /**
+     * A list of components that can be loaded on idle for performance optimization. These components generally used to support
+     * rendering the web part.
+     *
+     * @internal
+     *
+     * @privateRemarks
+     * Note: All top level JavaScript logic for the loaded component will be run upon loading the component.
+     *   If the component exports a default function, it will be called.
+     *
+     * example:
+     * ```
+     * idleLoadComponents: [{
+     *   displayMode: 'edit' | 'read' | 'all',
+     *   priority: 'high' | 'low',
+     *   componentId: 'abc5-...',
+     * }];
+     * ```
+     */
+    idleLoadComponents?: _IIdleLoadComponent[];
     /**
      * A Web Part can have pre-configured properties like the title, description, toolbox group name and Web
      * Part specific custom properties. And there can be multiple instances of these pre-configured properties.
@@ -204,6 +224,34 @@ export interface IClientSideWebPartManifest<TProperties> extends IClientSideComp
      * Ensure this remains up to date with IFlexibleControlSizingData in FlexibleControl.types.ts
      */
     flexibleLayoutSizing?: IFlexibleLayoutSizing;
+    /**
+     * @alpha
+     * Optional AI properties for the web part including the structure of AI properties and the mapping between
+     * AI properties and the web part property bag.
+     * If provided, AI scenarios like LLM agent in SharePoint Pages will be able to interact with the web part. For example,
+     * Creating a web part, modifying existing web part, better understanding of the web part's data structure, etc.
+     */
+    aiProperties?: IAIProperties;
+}
+/**
+ * @internal
+ * Definition: A component that can be loaded in the background to improve performance.
+ */
+export interface _IIdleLoadComponent {
+    /**
+     * The display mode in which the component should be loaded.
+     * If not specified, the component will be loaded in all display modes.
+     */
+    displayMode?: 'edit' | 'read';
+    /**
+     * The priority of the component to be loaded.
+     * High priority components will be loaded before low priority components.
+     */
+    priority: 'high' | 'low';
+    /**
+     * Manifest ID of the component to be loaded.
+     */
+    componentId: string;
 }
 /**
  * Flexible layout sizing data
@@ -501,4 +549,36 @@ export interface ICapabilityCollection {
      */
     AuthenticationModel?: Array<'OpenIDConnect' | 'Federated'>;
 }
+/**
+ * @alpha
+ * Defines the AI properties for the web part, including their structure and the mapping to the web part's property bag.
+ * When provided, AI scenarios such as an LLM agent in SharePoint Pages can interact with the web part,
+ * e.g., creating it, modifying it, or understanding its data structure.
+ */
+export interface IAIProperties {
+    /**
+     * The structure of AI properties for the web part.
+     */
+    structure: {
+        /**
+         * A free-form nested object not intended for direct use by web part developers.
+         * It is interpreted internally by the system based on the conversion logic
+         * between web part AI properties and JSON.
+         * The contract for this structure is internal and not exposed to developers.
+         */
+        [key: string]: unknown;
+    };
+    /**
+     * The mapping of AI properties to existing property bag.
+     */
+    mapping: {
+        /**
+         * A free-form nested object not intended for direct use by web part developers.
+         * It is interpreted internally by the system based on the conversion logic
+         * between web part AI properties and JSON.
+         * The contract for this structure is internal and not exposed to developers.
+         */
+        [key: string]: unknown;
+    };
+}
 //# sourceMappingURL=IClientSideWebPartManifest.d.ts.map

package/lib-esm/index.js

@@ -1,6 +1,5 @@
 export * from './manifestSchemas/IClientSideApplicationManifest';
 export * from './manifestSchemas/IClientSideAssemblyManifest';
-export * from './manifestSchemas/IClientSideComponentLoaderConfiguration';
 export * from './manifestSchemas/IClientSideComponentManifest';
 export * from './manifestSchemas/IClientSideExtensionManifest';
 export * from './manifestSchemas/IClientSideLibraryManifest';

package/lib-esm/manifestSchemas/examples/webpart.manifest.json

@@ -323,6 +323,68 @@
         "path": "nonAmdB.js",
         "globalName": "nonAmdB",
         "globalDependencies": ["nonAmdB"]
+      },
+      "fallbackFlighted": {
+        "type": "component",
+        "version": "1.2.3",
+        "id": "00000000-0000-0000-0000-000000000000",
+        "fallbackVersion": {
+          "version": "0.0.1",
+          "condition": {
+            "switchType": "flight",
+            "id": 12345
+          }
+        }
+      },
+      "fallbackKillSwitched": {
+        "type": "component",
+        "version": "1.2.3",
+        "id": "00000000-0000-0000-0000-000000000000",
+        "fallbackVersion": {
+          "version": "0.0.1",
+          "condition": {
+            "switchType": "killswitch",
+            "id": "00000000-0000-0000-0000-000000000000"
+          }
+        }
+      },
+      "fallbackComplexExpression": {
+        "type": "component",
+        "version": "1.2.3",
+        "id": "00000000-0000-0000-0000-000000000000",
+        "fallbackVersion": {
+          "version": "0.0.1",
+          "condition": {
+            "xor": [
+              {
+                "or": [
+                  {
+                    "switchType": "flight",
+                    "id": 12345
+                  },
+                  {
+                    "not": {
+                      "switchType": "killswitch",
+                      "id": "00000000-0000-0000-0000-000000000000"
+                    }
+                  }
+                ]
+              },
+              {
+                "and": [
+                  {
+                    "switchType": "flight",
+                    "id": 67890
+                  },
+                  {
+                    "switchType": "killswitch",
+                    "id": "11111111-1111-1111-1111-111111111111"
+                  }
+                ]
+              }
+            ]
+          }
+        }
       }
     }
   },

package/lib-esm/manifestSchemas/examples/webpart_1.manifest.js

@@ -328,6 +328,68 @@ const webpartManifest = {
                 globalDependencies: [
                     'nonAmdB'
                 ]
+            },
+            fallbackFlighted: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'flight',
+                        id: 12345
+                    }
+                }
+            },
+            fallbackKillSwitched: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'killswitch',
+                        id: '00000000-0000-0000-0000-000000000000'
+                    }
+                }
+            },
+            fallbackComplexExpression: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        xor: [
+                            {
+                                or: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 12345
+                                    },
+                                    {
+                                        not: {
+                                            switchType: 'killswitch',
+                                            id: '00000000-0000-0000-0000-000000000000'
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                and: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 67890
+                                    },
+                                    {
+                                        switchType: 'killswitch',
+                                        id: '11111111-1111-1111-1111-111111111111'
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                }
             }
         }
     },

package/lib-esm/manifestSchemas/examples/webpart_2.manifest.js

@@ -327,6 +327,68 @@ const webpartManifest = {
                 globalDependencies: [
                     'nonAmdB'
                 ]
+            },
+            fallbackFlighted: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'flight',
+                        id: 12345
+                    }
+                }
+            },
+            fallbackKillSwitched: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        switchType: 'killswitch',
+                        id: '00000000-0000-0000-0000-000000000000'
+                    }
+                }
+            },
+            fallbackComplexExpression: {
+                type: 'component',
+                version: '1.2.3',
+                id: '00000000-0000-0000-0000-000000000000',
+                fallbackVersion: {
+                    version: '0.0.1',
+                    condition: {
+                        xor: [
+                            {
+                                or: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 12345
+                                    },
+                                    {
+                                        not: {
+                                            switchType: 'killswitch',
+                                            id: '00000000-0000-0000-0000-000000000000'
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                and: [
+                                    {
+                                        switchType: 'flight',
+                                        id: 67890
+                                    },
+                                    {
+                                        switchType: 'killswitch',
+                                        id: '11111111-1111-1111-1111-111111111111'
+                                    }
+                                ]
+                            }
+                        ]
+                    }
+                }
             }
         }
     },

package/lib-esm/manifestSchemas/jsonSchemas/client-side-component-loader-configuration.schema.json

@@ -105,7 +105,8 @@
                         "shouldNotPreload": { "$ref": "any-value.schema.json" },
                         "version": { "$ref": "any-value.schema.json" },
                         "id": { "$ref": "any-value.schema.json" },
-                        "failoverPath": { "$ref": "any-value.schema.json" }
+                        "failoverPath": { "$ref": "any-value.schema.json" },
+                        "fallbackVersion": { "$ref": "any-value.schema.json" }
                       },
                       "additionalProperties": false
                     },
@@ -145,6 +146,10 @@
                           "title": "Failover Path",
                           "description": "A path to the framework-supplied module in case the framework fails to load the requested version. This must be either a fully-qualified URL, or a path under the paths specified in the \"internalModuleBaseUrls\" field. If this field is not specified and the version is not available in the framework runtime, the closest matching version of the module will be provided instead.",
                           "$ref": "#/definitions/path"
+                        },
+
+                        "fallbackVersion": {
+                          "$ref": "component-fallback-version.schema.json"
                         }
                       },
                       "additionalProperties": true

package/lib-esm/manifestSchemas/jsonSchemas/client-side-web-part-manifest.schema.json

@@ -166,6 +166,65 @@
             }
           },
           "additionalProperties": false
+        },
+        "idleLoadComponents": {
+          "description": "A list of components that can be loaded on idle for performance optimization. These components generally used to support rendering the web part.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "displayMode": {
+                "type": "string",
+                "enum": ["edit", "read"]
+              },
+              "priority": {
+                "type": "string",
+                "enum": ["high", "low"]
+              },
+              "componentId": {
+                "type": "string"
+              }
+            },
+            "required": ["priority", "componentId"]
+          }
+        },
+        "aiProperties": {
+          "type": "object",
+          "title": "References to AI properties and mapping definitions.",
+          "description": "Supports definition of web part AI properties and its mapping with existing property bag",
+          "required": ["structure", "mapping"],
+          "properties": {
+            "structure": {
+              "type": "object",
+              "title": "AI properties structure",
+              "description": "The structure of AI properties for the web part.",
+              "additionalProperties": false,
+              "required": ["id"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The identifier for the AI properties structure.",
+                  "pattern": "^\\$[^:]+:.+;$"
+                }
+              }
+            },
+            "mapping": {
+              "type": "object",
+              "title": "AI properties mapping",
+              "description": "The mapping of AI properties to existing property bag.",
+              "additionalProperties": false,
+              "required": ["id"],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The identifier for the AI properties mapping.",
+                  "pattern": "^\\$[^:]+:.+;$"
+                }
+              }
+            }
+          },
+          "additionalProperties": false
         }
       },
       "additionalProperties": false

package/lib-esm/manifestSchemas/jsonSchemas/component-fallback-version.schema.json

@@ -0,0 +1,106 @@
+{
+  "id": "component-fallback-version.schema.json",
+  "title": "Component Fallback Version",
+  "description": "Represents a fallback version of a component that can be used under certain logical conditions, including flight and killswitch checks.",
+  "type": "object",
+  "required": ["version", "condition"],
+  "properties": {
+    "version": {
+      "description": "The version of the component to be used as a fallback.",
+      "oneOf": [{ "$ref": "semver.schema.json" }]
+    },
+    "condition": {
+      "description": "The condition under which the fallback version should be used. Supports logical operators and flight/killswitch checks.",
+      "$ref": "#/definitions/operatorOrSwitch"
+    }
+  },
+  "definitions": {
+    "operatorOrSwitch": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["and"],
+          "properties": {
+            "and": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/definitions/operatorOrSwitch" }
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["or"],
+          "properties": {
+            "or": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/definitions/operatorOrSwitch" }
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["xor"],
+          "properties": {
+            "xor": {
+              "type": "array",
+              "minItems": 2,
+              "maxItems": 2,
+              "items": { "$ref": "#/definitions/operatorOrSwitch" }
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["not"],
+          "properties": {
+            "not": { "$ref": "#/definitions/operatorOrSwitch" }
+          },
+          "additionalProperties": false
+        },
+        { "$ref": "#/definitions/flightOrKillSwitch" }
+      ]
+    },
+    "flightOrKillSwitch": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["switchType", "id"],
+          "properties": {
+            "switchType": {
+              "type": "string",
+              "enum": ["flight"],
+              "description": "Indicates this is a flight check."
+            },
+            "id": {
+              "type": "integer",
+              "description": "The numeric ID of the flight."
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["switchType", "id"],
+          "properties": {
+            "switchType": {
+              "type": "string",
+              "enum": ["killswitch"],
+              "description": "Indicates this is a killswitch check."
+            },
+            "id": {
+              "$ref": "guid.schema.json",
+              "description": "The GUID of the killswitch."
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/sp-module-interfaces",
-  "version": "1.22.0-beta.1",
+  "version": "1.22.0-beta.3",
   "description": "SharePoint Framework module interfaces",
   "license": "https://aka.ms/spfx/license",
   "homepage": "http://aka.ms/spfx",
@@ -34,11 +34,11 @@
     "tsdocFlavor": "AEDoc"
   },
   "dependencies": {
-    "@rushstack/node-core-library": "5.13.1",
+    "@rushstack/node-core-library": "5.14.0",
     "z-schema": "6.0.2"
   },
   "devDependencies": {
-    "@rushstack/heft": "0.73.6",
+    "@rushstack/heft": "0.74.3",
     "eslint": "8.57.1",
     "@msinternal/internal-no-asset-postprocess-node-rig": "0.1.0"
   },