v4.0.0

4.0.0 (2024-02-05)

⚠ BREAKING CHANGES

• mgt-loader.js is removed and there is no support for es5 only browsers direct from CDN. Developers loading mgt from a CDN must use module syntax and explicitly initialize their applications.
• mgt-spfx is deprecated, use disambiguation instead
• ViewType is now a string union type and not an enum
• UserType is now a string union type and not an enum
• PersonType is now a string union type and not an enum
• GroupType is now a string union type and not an enum
• groupType property on MgtPeoplePicker is now a GroupType[] not a GroupType that is a bitmask of the desired group types. Developers using the group-type attribute will find the behavior unchanged.
• the avatarType eunm has been renamed to AvatarType for consistency and converted to a string union type
• the ResponseType for mgt-get is now a string union type and not an enum
• PersonCardInteraction is now a string union type and not an enum
• convert attribute enums to string unions (#2962)
• PersonViewType has been removed. 'avatar' is no longer a valid value for the 'view' attribute on the 'mgt-person' component
• permissions: applications using mgt-person with fetch-image and person-detal where the supplied value is a group will now need to consent to either Group.Read.All or Group.ReadWrite.All. This replaces the existing behavior where the group image would silently fail to load and show an http 403 error in the console.
• permissions: minimal permission for planner calls changed from Group.ReadWrite.All to Tasks.ReadWrite for write operation and from Group.Read.All to Tasks.Read for read operations.
• prepScopes now accepts an array of scopes, this is checked against the set of currently consented scopes for the user. If any of the supplied scopes are found, then no additional scopes are requested. If no match is found, then the user will be prompted to consent to the first scope in the supplied array of scopes
• mgt-tasks has been removed and replaced with mgt-planner. mgt-planner does not support data-source switching to fetch data from the outlook tasks apis any longer.
• Developers must explicitly call the register function for all web components used in their application when using components from @microsoft/mgt-components. Importing from the root of @microsoft/mgt-components no longer has an automatic registration side effect. NOTE Components from @microsoft/mgt-react will automatically register the underlying web component when they are used for the first time.
• MgtPersonCard no longer has a static config property.This config has been moved to the MgtPersonCardConfig class to allow developers to import the config and associated getMgtPersonCardScopes function at the top level of their applicaiton without automatically adding the weight of the full mgt-person-card component and dependencies to the entry file for their applications.
• default behavior of mgt-people-picker changes so presence is not shown unless show-presence attribute or showPresence property are set
• applications importing @microsoft/mgt-react but not using the wrapper components will not have components automatically registered in the browser. This leads to a breaking change when these applications emit raw web component markup rather than using the wrapper components.

Features

• add edit funtionality to mgt-todo (#2783) (64acd1f)
• add ElectronContextBridgeProvider (#2914) (8900eb4)
• add optional person-card to people picker (#2900) (65ca8e2)
• add show-presence to mgt-people-picker (#2812) (f5bf7cc)
• add support for nested values in mgt-picker key-name (#2917) (e79fbdc)
• automatically convert disambiguation value to lowercase (#2898) (992ab85)
• convert attribute enums to string unions (#2962) (18d0aec)
• deprecate mgt-spfx package (#2940) (3da9560)
• enable live code inclusion for consuming applications (#2642) (c41d719)
• enable user sign-in for storybook (#2851) (335c2f3)
• promoting search components to GA (#2909) (86697f4)
• remove mgt-loader (#2963) (ea0f71b)
• rename mgt-tasks to mgt-planner (#2890) (df8af8c)
• require explicit component registration (#2848) (b7db262)
• scope aware requests (#2797) (81d124b)
• split config and permission methods out of mgt-person-card (#2840) (8177699)
• use @lit/task to schedule async data fetching (#2912) (14a96ff)

Bug Fixes

• add connect img and frame csp directives (#2910) (20eb7fc)
• add detail-line part attribute to person component (#2999) (b254e49)
• add focus on input field when you click the button to add a new task (#2994) (573fa45)
• add method to clear selected channel in mgt-teams-channel-picker (#2865) (c3a3d82)
• adding headers and count on all potential advanced aad queries (#2920) (90b2dd1)
• clean-up react-contoso homepage (#3008) (c8c564d)
• color inversion on suggestion list (65ca8e2)
• consolidate person view types (#2943) (6d44a17)
• correct completion of todo items (#3018) (52d8ad9)
• correct filter concatenation in mgt-people-picker (#2822) (18925a9)
• correct permissions used for some requests (#2953) (ec25e57)
• direct reports list formatting (#2930) (f2547d1)
• enable the input control when selectedPeople is cleared via code. (#2792) (f54dc81)
• ensure filtering of tasks actually works (#2894) (59cccb0)
• ensure loginInitiated is fired every time (2fb1064)
• ensure people-filters are added with and clause for people-picker (#2826) (0d671e6)
• enter email keypress behavior (#2928) (53b291c)
• flyout vertical positioning (#2771) (45163ed)
• focus on the input when you cancel adding a todo (#3005) (14bb9c1)
• guard on non-existent result (#2931) (981e6f9)
• increase area for placeholder (#2921) (513031b)
• mgt-person avatar size customization in vertical layout (#2875) (4c41534)
• msal setActiveAccount error (#3017) (0bad7e5)
• permissions: getGroupImage now correctly requires group.read.all or group.readwrite.all (#2797) (81d124b)
• permissions: updated todo and planner permissions (#2797) (81d124b)
• presence fallback logic (#2849) (1ab1970)
• presence icons for dark forced colors (#2817) (00b168b)
• register components for use in stories (335c2f3)
• remove readonly props from react components (#2946) (267bc19)
• revert csp tag in developer index.html (#2910) (20eb7fc)
• set add button to disabled until task name is provided (#2996) (eec74d0)
• stop keydown from bubbling beyond people-picker (#2892) (ad4cfa3)
• typing for LocalizationHelper.strings (#2998) (0317fc2)
• update person details when mgt-person attributes are changed (#2871) (9c53cbf)
• update rollup and rollup config (#2969) (606fffb)
• update the sandbox fallback url (#2924) (ebf5ed3)

Code Refactoring

• avatarType renamed to AvatarType and converted to string union type (18d0aec)
• GroupType is now a string union type and not an enum (18d0aec)
• groupType property on MgtPeoplePicker is now GroupType[] (18d0aec)
• PersonCardInteraction is now a string union type and not an enum (18d0aec)
• PersonType is now a string union type and not an enum (18d0aec)
• ResponseType for mgt-get converted to string union type from enum (18d0aec)
• UserType is now a string union type and not an enum (18d0aec)
• ViewType is now a string union type and not an enum (18d0aec)