Releases: microsoftgraph/microsoft-graph-toolkit
v3.0.0
We're excited to announce our Release v3.0.0 of the Microsoft Graph Toolkit 馃馃帀! In this release, we have a large number of fixes, new features, accessibility improvements and general new enhancements. The full list is below! But in short, we'd love to highlight key capabilities:
馃帀 Highlights
MGT.v3.0.-.Feature.Video.mp4
Infrastructure updates
We updated the Microsoft Graph JavaScript SDK to the version 3 to benefit from all the latest capabilities including support for large files uploads and better error handling. While making this change, we also enabled leveraging the Toolkit in sovereign clouds.
Major styling updates
We enhanced the styling of all our components to meet our accessibility standards and to fully embrace Fluent 2 and its implementation in web components. Your applications will feel a lot more connected to the rest of Microsoft 365 by having the familiar look and feel, simplifying the adoption and usage of your apps for your users! We also updated our dark and light themes to feel closer to Microsoft 365 experiences.
Improved the SharePoint Framework development experience
In the past, if you wanted to build SharePoint Framework (SPFx) apps, you had to deploy a common library component providing a single instance of the Toolkit for all web parts in the tenant. This was cumbersome, easily missed and did not provide great experience for applications acquired through the store. Thanks to our disambiguation features, we now allow developers to define prefixes to their components to avoid any naming collisions in shared environments like SharePoint pages. Disambiguation is intended to provide developers with a mechanism to use a specific version of the Toolkit in their solution without encountering collisions with other solutions that may be using the Toolkit.
New scenarios
Select an item from a collection of entities
As part of v3.0, we are adding a new mgt-picker component, allowing generic selection of Microsoft Graph entities from collections. It鈥檚 intended to be used to select an item from a list of items, for example a task list from the user鈥檚 task lists, a user from its direct reports, a list from a site, etc.
Easily switch between light and dark mode
To simplify switching from one theme to the next, we are introducing a mgt-theme-toggle component. This component can be used to change the theme experience from light to dark mode (and vice versa). You can also use our internal utilities to invoke the same using your custom code.
Select a term from Microsoft Graph taxonomy
We are adding a new mgt-taxonomy-picker component, allowing selection of Microsoft Graph taxonomy entities. Built on top of our mgt-picker component, it鈥檚 intended to be used to select a term from a term set. We want to share our gratitude to the contributor of this new component, Anoop Tatti, for this highly requested component!
Build a search-driven application
As requested by our community, we wanted to provide a new capability that allows developers to build solutions leveraging the Microsoft Graph search APIs. Up until now, it was not possible to use any of our components, including the mgt-get component to achieve this scenario. Starting with this release, we are excited to add 2 new components helping you to build search scenarios: mgt-search-box and mgt-search-results! These components, when used together, can offer a perfect foundation for a search-driven application.
Improved scenarios
Seamlessly switch between accounts
We heard from a lot of our partners and customers that offering a mechanism to allow multiple users connected to be able to switch to a different user account was key to a great experience. We鈥檙e bringing multi-account support to our mgt-login component in this version!
Send messages while staying in-context
We had a basic messaging feature in our mgt-person-card and wanted to bring a fully featured message box that allows users to send quick messages to others while staying in the flow of their work. We are introducing this new quick chat message in this preview version.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt
If you鈥檙e using the Toolkit via mgt-loader and update your script tag to:
<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
This update includes breaking changes that may impact your application, such as deprecation of properties, use of the embedded Microsoft Graph client and naming updates to CSS custom properties. Please refer to our upgrade guide to see a detailed list of the changes.
馃帹What's Changed
- Updated Graph Client to v3 by @nmetulev in #1040
- [person]: Update person component to latest Fluent UI design by @Mnickii in #1773
- chore: update fluent with main by @Mnickii in #1804
- feature: update File component to latest Fluent design by @Mnickii in #1802
- feature: Update Person Card to latest Fluent UI by @Mnickii in #1797
- feat: update mgt-login to new fluent-ui designs by @gavinbarron in #1807
- feature: Update the people component to Fluent UI by @musale in #1786
- feature: Update people-picker component to fluentui design by @musale in #1801
- chore: update to lit 2.0 by @gavinbarron in #1810
- fix: lock responselike resolutions to v2.0.0 by @Mnickii in #1851
- feat: no-framework spfx webpart by @gavinbarron in #1863
- fix: People picker RTL renders, focus and storybook loading errors by @musale in #1864
- Next/node16 support by @gavinbarron in #1911
- fix: restore provided msal public client behavior by @gavinbarron in #1931
- feat: add support for GCC and other sovereign clouds by @musale in #1928
- chore: upgrade sample to angular 14 by @gavinbarron in #1968
- docs: update README to remove 404s by @sebastienlevert in #1990
- feat: add custom element disambiguation by @gavinbarron in #1852
- docs: adds version information to storybook by @gavinbarron in #1999
- Removed the selected-item template by @sebastienlevert in #2004
- feat: add tests and example jest config by @gavinbarron in #1987
- bug: fix html title for mgt.dev by @gavinbarron in #2019
- chore: send notification to teamsfx when new version released by @SLdragon in #1994
- feat: add spfx utils for disambiguation by @gavinbarron in #1914
- fix: fix dynamic group id people picker story by @gavinbarron in #2023
- feat: typed events by @gavinbarron in #1981
- Update TeamsFxProvider.ts for Graph Toolkit 3.0 by @SLdragon in #1983
- feature: update File List component to Fluent UI by @Mnickii in #1833
- bug: people picker state management by @gavinbarron in #2028
- Fix: PeoplePicker add removePerson safety input check by @masashiswingle in #2033
- fix: correct typing problems in sample vue app by @gavinbarron in https://gi...
v2.11.2
We're excited to announce our v2.11.1 release of the Microsoft Graph Toolkit 馃! In this patch release, we did 1 fix to solve issues with loading data for file lists.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@latest
If you鈥檙e using the Toolkit via mgt-loader
, your application will be automatically updated to the newest version.
馃悶 Fixes
Full Changelog: v2.11.0...v2.11.2
v3.0.0-rc.3
We're excited to announce our Release Candidate for v3.0.0 of the Microsoft Graph Toolkit 馃, v3.0.0-rc.3! Why rc.3 in the version number? Because @gavinbarron forgot about how versioning of SharePoint framework solutions works and took a couple of attempts to get a release with a package for mgt-spfx
to be included 馃槖. In this release, we have a number of fixes, accessibility improvements and new enhancements.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@3.0.0-rc.3
If you鈥檙e using the Toolkit via mgt-loader and update your script tag to:
<script src="https://unpkg.com/@microsoft/mgt@v3.0.0-rc.3/dist/bundle/mgt-loader.js"></script>
馃帹 Enhancements:
- Removed the Teams, TeamsMsal2 and the Msal providers in v3.x.x by @musale in #2231
- Added mgt-taxonomy-picker control by @anoopt in #2172
- Added mgt-picker selected-value attribute by @gavinbarron in #2363
- Added preview component support by @gavinbarron in #2356
- Added design token overrides to theme switching by @gavinbarron in #2328
馃悶 Bugs fixed:
- Removed theme-toggle capability from custom CSS property and templating stories by @musale in #2326
- Include mgt-mock-provider as dependency to mgt by @gavinbarron in #2336
- Fixes person component responsive issue by @Mnickii in #2297
- Fixes person text visibility in custom properties by @Mnickii in #2298
- Adds title tag in location icon svg by @musale in #2285
- Open file/folder in new window when you press enter/space on it by @musale in #2325
- Fixes keyboard navigation of login account list by @gavinbarron in #2289
- Make tasks header navigable with the keyboard. by @musale in #2313
- Sethe teams-channel-picker dropdown to overlay all other elements by @musale in #2337
- Fixes storybook footer accessibility by @gavinbarron in #2369
- Fixes new task select rendering by @gavinbarron in #2368
- Fixes override design token logic by @gavinbarron in #2384
- Fixes running beta queries and eliminate re-renders in mgt-search-results by @sebastienlevert in #2391
- Makes editor tabs in playground keyboard navigable by @gavinbarron in #2371
- Sets react peer dependency as range by @gavinbarron in #2393
- Adds aria-label text to announce cancelling adding a new task by @musale in #2359
馃搩Changelog
Full Changelog: v3.0.0-preview.2...v3.0.0-rc.3
v2.11.1
We're excited to announce our v2.11.1 release of the Microsoft Graph Toolkit 馃! In this minor release, we did 1 fix to solve issues with React dependencies.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@latest
If you鈥檙e using the Toolkit via mgt-loader
, your application will be automatically updated to the newest version.
馃悶 Fixes
- Remove react peer dependency by @gavinbarron in #2389
馃搩Changelog
The full changelog is available here
v2.11.0
We're excited to announce our v2.11.0 release of the Microsoft Graph Toolkit 馃! In this minor release, we did 2 fixes and 2 new enhancements.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@latest
If you鈥檙e using the Toolkit via mgt-loader
, your application will be automatically updated to the newest version.
馃帹 Enhancements
- Mark Teams, TeamsMsal2 and Msal providers as deprecated in v2.x.x by @musale in #2232
- Add custom focus ring color by @gavinbarron in #2334
馃悶 Fixes
- Suggested people aria labels by @gavinbarron in #2335
- Update mgt-file-upload.ts by @stoubian in #2358
- React peer dependencies by @gavinbarron in #2254
馃帀 Celebrating our contributors
馃搩Changelog
The full changelog is available here
v3.0.0-preview.2
We are excited to announce the second preview release for v3.0.0 of the Microsoft Graph Toolkit. This release includes a number of fixes and new features.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@3.0.0-preview.2
If you鈥檙e using the Toolkit via mgt-loader and update your script tag to:
<script src="https://unpkg.com/@microsoft/mgt@v3.0.0-preview.2/dist/bundle/mgt-loader.js"></script>
馃帹 Enhancements:
- use fluent UI to theme the tasks component (#2150) by Musale Martin
- move completed items to bottom of the list in mgt-todo (#2215) by Nickii Miaro
- Support for new component mgt-search-results (#2047) by S茅bastien Levert
- update Todo component to new Fluent designs (#1967) by Nickii Miaro
- use fluentui to theme the person component. (#2072) by Musale Martin
- allow programmatically theming a component without the theme-toggle component (#2199) by Musale Martin
- migrate to eslint (#2125) by Gavin Barron
- added spec for mgt-taxonomy-picker (#2156) by Anoop T
- add custom CSS properties for the people picker flyout text (#2162) by Musale Martin
- Storybook authentication (#2048) by S茅bastien Levert
- use fluentui tokens for theming file and file-list (#2044) by Musale Martin
馃悶 Bugs fixed:
- use fixed graph client version (#2274) by Gavin Barron
- react peer dependencies (#2254) by Gavin Barron
- remove mgt-spfx dependency from react webpart sample (#2196) by Gavin Barron
- fix mgt-spfx-utils packing (#2195) by Gavin Barron
馃帀 Celebrating our contributors
馃搩Changelog
The full changelog is available here
v2.10.1
We're excited to announce our v2.10.1 release of the Microsoft Graph Toolkit 馃! In this minor release, we did 4 fixes and 1 new enhancement.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@latest
If you鈥檙e using the Toolkit via mgt-loader
, your application will be automatically updated to the newest version.
馃帹 Enhancements
馃悶 Fixes
- people picker option labels by @gavinbarron in #2207
- voice over for person in list by @gavinbarron in #2206
- prevent undefined in people-picker option labels for line two by @gavinbarron in #2211
- people-picker set focus on list navigation by @gavinbarron in #2219
馃搩Changelog
The full changelog is available here
v2.10.0
We're excited to announce our v2.10.0 release of the Microsoft Graph Toolkit 馃! In this minor release, we did 4 fixes and 2 new enhancements.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@latest
If you鈥檙e using the Toolkit via mgt-loader
, your application will be automatically updated to the newest version.
馃帹 Enhancements
- storybook: added the auth page for storybook use #2126 by @sebastienlevert
- mgt-people-picker: added new custom CSS properties for the flyout text #2162 by @musale
馃悶 Fixes
- mgt-people-picker: announce suggestion list changes #2148 by @gavinbarron
- mgt-people-picker: request state update after setting the selectedPeole #2163 by @musale
- storybook: accessibility issues #2129 by @gavinbarron
- storybook: hide the canvas button #2145 by @gavinbarron
馃搩Changelog
The full changelog is available here
v3.0.0-preview.1
We are excited to announce the first preview release for v3.0.0 of the Microsoft Graph Toolkit. This release includes a number of breaking changes and new features.
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@3.0.0-preview.1
If you鈥檙e using the Toolkit via mgt-loader and update your script tag to:
<script src="https://unpkg.com/@microsoft/mgt@v3.0.0-preview.1/dist/bundle/mgt-loader.js"></script>
馃帹 Enhancements:
- updated Graph Client to v3 (#1040) by Nikola Metulev
- msal2 multi-account UI (#1041) by Nicolas Vogt
- person-card fluent controls upgrade (#1253) by Nicolas Vogt
- added multi-user cache functionality and enabled multi user login in Msal2Provider (#1299) by amrutha95
- added option to disable incremental consent (#1316) by amrutha95
- update fluentui registration (#1338) by Beth Pan
- update person component to latest Fluent UI design (#1773) by Nickii Miaro
- update the people component to Fluent UI (#1786) by Musale Martin
- update Person Card to latest Fluent UI (#1797) by Nickii Miaro
- update people-picker component to fluentui design (#1801) by Musale Martin
- update File component to latest Fluent design (#1802) by Nickii Miaro
- update teams-channel-picker to fluent UI designs (#1805) by Musale Martin
- update mgt-login to new fluent-ui designs (#1807) by Gavin Barron
- update File List component to Fluent UI (#1833) by Nickii Miaro
- add custom element disambiguation #1852) by Gavin Barron
- update agenda component to the fluent UI spec (#1867) by Musale Martin
- add nodejs 16 support (#1911) by Gavin Barron
- add spfx utils for disambiguation (#1914) by Gavin Barron
- add support for GCC and other sovereign clouds (#1928) by Musale Martin
- mgt-picker component for generic picking of entities from Microsoft Graph (#1937) by Nickii Miaro
- add quick messaging to fluent person-card (#1958) by Nickii Miaro
- upgrade sample to angular 14 (#1968) by Gavin Barron
- add typing to events for react components (#1981) by Gavin Barron
- update TeamsFxProvider.ts for v3.0.0 (#1983) by rentu
- add tests and example jest config (#1987) by Gavin Barron
- add theme management tools (#2037) by Gavin Barron
- report custom element name collisions (#2053) by Gavin Barron
馃悶 Bugs fixed:
- fix: lock responselike resolutions to v2.0.0 (#1851) by Nickii Miaro
- fix: people picker RTL renders, focus and storybook loading errors (#1864) by Musale Martin
- fix: restore provided msal public client behavior (#1931) by Gavin Barron
- fix: update typescript and ts-node versions for proxy samples (#2020) by Gavin Barron
- fix: correct typing problems in sample vue app (#2021) by Gavin Barron
- fix: set the search icon to be on the same level with the input field (#2043) by Musale Martin
馃毃 Breaking Changes:
- In mgt-agenda for eventClick the clicked MicrosoftGraph.Event moves from a property of e.detail to be the value of e.detail
- All events for mgt-task now emit a CustomEvent
- Numerous changes to design tokens that may break styling customizations
- @microsoft/microsoft-graph-client now uses v3.0.2, upgraded from v2.2.1, solutions using the graph client from the provider will experience breaking changes.
馃搩Changelog
The full changelog is available here
v2.9.2
We're excited to announce our v2.9.2 release of the Microsoft Graph Toolkit 馃! In this patch release, we did 1 fix. We are also welcoming one new contributor!
Updating your application
To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:
npm i @microsoft/mgt@latest
If you鈥檙e using the Toolkit via mgt-loader, your application will be automatically updated to the newest version.
馃悶 Fixes
- mgt-person: fix avatar scaling issue by @JoshWhite in #2071
馃帀 Celebrating our contributors
- @JoshWhite made their first contribution in #2071
馃搩Changelog
The full changelog is available here