@devsym/graph-toolkit-react 1.0.0-next.7 → 1.0.0-next.9

package/dist/providers/IPersonDataProvider.d.ts

@@ -1,5 +1,6 @@
 /**
- * Person data provider interface for fetching user information, presence, and photos
+ * Person data provider interface for fetching user information, presence, and photos,
+ * and optionally searching for people.
  */
 import { Presence, User } from '@microsoft/microsoft-graph-types';
 import { IProvider } from './IProvider';
@@ -19,6 +20,12 @@ export interface ProviderPersonDataRequest {
      * Whether to fetch profile photo
      */
     fetchPhoto: boolean;
+    /**
+     * Additional user profile fields to fetch beyond the default set.
+     * Each entry must be a valid OData field name (letters, digits, underscores, dots, or slashes).
+     * Empty strings and entries containing unsafe characters are ignored.
+     */
+    selectFields?: string[];
 }
 /**
  * Response data containing user information, presence, and photo
@@ -54,4 +61,51 @@ export interface IPersonDataProvider {
  * @returns True if the provider implements IPersonDataProvider
  */
 export declare const isPersonDataProvider: (provider: IProvider | null) => provider is IProvider & IPersonDataProvider;
+/**
+ * Result item returned by a people search operation
+ */
+export interface PeopleSearchResult {
+    /**
+     * The unique identifier for the person
+     */
+    id: string;
+    /**
+     * The person's display name
+     */
+    displayName?: string | null;
+    /**
+     * The person's primary mail address
+     */
+    mail?: string | null;
+    /**
+     * The person's user principal name
+     */
+    userPrincipalName?: string | null;
+    /**
+     * The person's job title
+     */
+    jobTitle?: string | null;
+    /**
+     * The department the person belongs to
+     */
+    department?: string | null;
+}
+/**
+ * Optional interface that providers can implement to support people search
+ */
+export interface IPeopleSearchProvider {
+    /**
+     * Search for people matching the given query string
+     * @param query - The search query (display name, email, or UPN fragment)
+     * @param maxResults - Maximum number of results to return (default: 10)
+     * @returns Promise resolving to an array of matching people
+     */
+    searchPeople(query: string, maxResults?: number): Promise<PeopleSearchResult[]>;
+}
+/**
+ * Type guard to check if a provider implements the IPeopleSearchProvider interface
+ * @param provider - The provider to check
+ * @returns True if the provider implements IPeopleSearchProvider
+ */
+export declare const isPeopleSearchProvider: (provider: IProvider | null) => provider is IProvider & IPeopleSearchProvider;
 //# sourceMappingURL=IPersonDataProvider.d.ts.map

package/dist/providers/IPersonDataProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IPersonDataProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IPersonDataProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxF;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,SAAS,GAAG,IAAI,KACzB,QAAQ,IAAI,SAAS,GAAG,mBAM1B,CAAC"}
+{"version":3,"file":"IPersonDataProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IPersonDataProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxF;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,SAAS,GAAG,IAAI,KACzB,QAAQ,IAAI,SAAS,GAAG,mBAM1B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;CACjF;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,SAAS,GAAG,IAAI,KACzB,QAAQ,IAAI,SAAS,GAAG,qBAM1B,CAAC"}

package/dist/providers/MockProvider.d.ts

@@ -2,8 +2,8 @@
  * MockProvider - simple in-memory provider for development and tests
  */
 import { IProvider, ProviderState } from './IProvider';
-import { IPersonDataProvider, ProviderPersonDataRequest, ProviderPersonDataResponse } from './IPersonDataProvider';
-export declare class MockProvider implements IProvider, IPersonDataProvider {
+import { IPersonDataProvider, IPeopleSearchProvider, PeopleSearchResult, ProviderPersonDataRequest, ProviderPersonDataResponse } from './IPersonDataProvider';
+export declare class MockProvider implements IProvider, IPersonDataProvider, IPeopleSearchProvider {
     private state;
     private listeners;
     constructor(options?: {
@@ -12,6 +12,7 @@ export declare class MockProvider implements IProvider, IPersonDataProvider {
     });
     getAccessToken(): Promise<string>;
     getPersonData(request: ProviderPersonDataRequest): Promise<ProviderPersonDataResponse>;
+    searchPeople(query: string, maxResults?: number): Promise<PeopleSearchResult[]>;
     login(): Promise<void>;
     logout(): Promise<void>;
     getState(): ProviderState;

package/dist/providers/MockProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MockProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAK/B,qBAAa,YAAa,YAAW,SAAS,EAAE,mBAAmB;IACjE,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAAuB;gBAC5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAMnE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ3B,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA+BtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,IAAI;CASb;AAED,eAAO,MAAM,0BAA0B,oBAA+C,CAAC"}
+{"version":3,"file":"MockProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MockProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAyF/B,qBAAa,YAAa,YAAW,SAAS,EAAE,mBAAmB,EAAE,qBAAqB;IACxF,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAAuB;gBAC5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAMnE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ3B,aAAa,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA+BtF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAe3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,IAAI;CASb;AAED,eAAO,MAAM,0BAA0B,oBAA+C,CAAC"}

package/dist/providers/MsalBrowserProvider.d.ts

@@ -1,15 +1,27 @@
 /**
  * Native MSAL browser provider for Graph Toolkit React
  */
-import { PublicClientApplication } from '@azure/msal-browser';
+import type { IPublicClientApplication } from '@azure/msal-browser';
 import { IProvider, ProviderState } from './IProvider';
+/**
+ * Error indicating that an interactive redirect has been initiated and token acquisition
+ * will continue after navigation completes.
+ */
+export declare class RedirectInProgressError extends Error {
+    /**
+     * Creates a new instance of RedirectInProgressError.
+     *
+     * @param message - A human-readable description of the redirect state.
+     */
+    constructor(message: string);
+}
 export declare class MsalBrowserProvider implements IProvider {
     private readonly msalInstance;
     private readonly defaultScopes;
     private account;
     private state;
     private listeners;
-    constructor(msalInstance: PublicClientApplication, defaultScopes: string[]);
+    constructor(msalInstance: IPublicClientApplication, defaultScopes: string[]);
     initialize(): Promise<void>;
     login(): Promise<void>;
     logout(): Promise<void>;

package/dist/providers/MsalBrowserProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MsalBrowserProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MsalBrowserProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIL,uBAAuB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,SAAS,CAAyB;gBAE9B,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,EAAE;IAKpE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BxD,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;CASb"}
+{"version":3,"file":"MsalBrowserProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MsalBrowserProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAe,wBAAwB,EAAkC,MAAM,qBAAqB,CAAC;AACjH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,SAAS,CAAyB;gBAE9B,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,EAAE;IAKrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAWvB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BxD,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;CASb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devsym/graph-toolkit-react",
-  "version": "1.0.0-next.7",
+  "version": "1.0.0-next.9",
   "description": "React components for Microsoft Graph powered by Fluent UI",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -69,13 +69,14 @@
     "@microsoft/microsoft-graph-types": "^2.40.0"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.7",
     "@azure/msal-browser": "^5.2.0",
+    "@changesets/cli": "^2.29.7",
     "@fluentui/react-components": "^9.72.6",
     "@storybook/addon-a11y": "^10.0.6",
     "@storybook/addon-docs": "^10.0.6",
     "@storybook/addon-links": "^10.0.6",
     "@storybook/react-vite": "^10.0.6",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",

package/readme.md

@@ -5,18 +5,18 @@
 <h4 align="center">Modern React Components for <a href="https://graph.microsoft.com">Microsoft Graph</a> powered by <a href="https://react.fluentui.dev/">Fluent UI</a></h4>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/alpha-0.1.0-orange" alt="Alpha Release">
+  <a href="https://www.npmjs.com/package/@devsym/graph-toolkit-react"><img src="https://img.shields.io/badge/alpha-0.1.0-orange" alt="Alpha Release"></a>
   <img src="https://img.shields.io/badge/React-18%2F19-blue" alt="React 18/19">
   <img src="https://img.shields.io/badge/Fluent_UI-9.72-purple" alt="Fluent UI 9">
   <img src="https://img.shields.io/badge/TypeScript-5.9-blue" alt="TypeScript 5.9">
 </p>
 
 <h3 align="center">
-  <a href="#getting-started">Get Started</a> • 
-  <a href="#migration-from-mgt">Migration</a> • 
-  <a href="#agent-quick-reference">Agent Quick Reference</a> • 
-  <a href="#storybook">Storybook</a> • 
-  <a href="#contribute">Contribute</a>
+  <a href="#-getting-started">Get Started</a> • 
+  <a href="#-migration-from-mgt">Migration</a> • 
+  <a href="#-agent-quick-reference">Agent Quick Reference</a> • 
+  <a href="#-storybook">Storybook</a> • 
+  <a href="#-contribute">Contribute</a>
 </h3>
 
 ## 🎯 Project Vision
@@ -52,7 +52,6 @@ npm install @devsym/graph-toolkit-react
 | ------- | ------- | ----------- |
 | `@devsym/graph-toolkit-react` | `0.1.0-alpha.1` | React components for Microsoft Graph powered by Fluent UI |
 
-<a id="migration-from-mgt"></a>
 ## 🔄 Migration from MGT
 
 For migration from Microsoft Graph Toolkit (including Teams-hosted scenarios), use [`docs/MGT_MIGRATION.md`](./docs/MGT_MIGRATION.md).
@@ -64,7 +63,6 @@ The guide includes:
 - Teams-specific migration section (`TeamsHostedProvider` + backend token exchange)
 - Common migration pitfalls and validation checklist
 
-<a id="agent-quick-reference"></a>
 ## 🤖 Agent Quick Reference
 
 If you are using a coding agent (Copilot/Codex/Claude/etc.), use the scenario-first reference in [`AGENTS.md`](./AGENTS.md).
@@ -101,8 +99,37 @@ import { Person } from '@devsym/graph-toolkit-react';
 
 `Person` supports Fluent UI Persona props directly.
 
+MGT-style line customization is also supported:
+
+```tsx
+<Person
+  userId="me"
+  view="threelines"
+  line1Property="givenName"
+  line2Property="mail,userPrincipalName"
+  line3Property="presenceAvailability"
+/>
+```
+
+For full manual override, use React render callbacks as the replacement for MGT line templates:
+
+```tsx
+<Person
+  personDetails={{
+    displayName: 'Megan Bowen',
+    jobTitle: 'CEO',
+    department: 'Leadership',
+    officeLocation: 'Seattle',
+  }}
+  view="fourlines"
+  renderLine1={({ text }) => <span>Name: {text}</span>}
+  renderLine2={({ text }) => <span>Role: {text}</span>}
+  renderLine3={({ text }) => <span>Org: {text}</span>}
+  renderLine4={({ text }) => <span>Location: {text}</span>}
+/>
+```
+
 
-<a id="getting-started"></a>
 ## 🚀 Getting Started
 
 ### Prerequisites
@@ -194,6 +221,8 @@ function App() {
 }
 ```
 
+The provider uses redirect flow. Set the redirect URI to your app's origin and register it as a **Single-page application (SPA)** platform in Azure AD.
+
 #### `TeamsHostedProvider` quick start (consumer-managed Teams login)
 
 Use this when your app is hosted in Microsoft Teams and your app code already handles TeamsJS auth for multiple APIs.
@@ -258,7 +287,6 @@ class MyAuthProvider implements IProvider {
 }
 ```
 
-<a id="storybook"></a>
 ## 📚 Storybook
 
 Explore all components interactively in our Storybook documentation:
@@ -344,12 +372,11 @@ stories/
 - ✅ Sample app with MSAL sign-in and `Person` (`userId="me"`) at `samples/react-msal-sample`
 
 **Next Steps**:
-- Additional components (PeoplePicker, PersonCard, Login)
+- Additional components (PeoplePicker, PersonCard, Login) — see [`docs/COMPONENT_ROADMAP.md`](./docs/COMPONENT_ROADMAP.md) for the full ranked list
 - Expanded provider guidance and production auth examples
 - Comprehensive test coverage
 - First stable release (1.0.0)
 
-<a id="contribute"></a>
 ## 🤝 Contribute
 
 This **community-driven project** provides React developers with components for Microsoft Graph. Contributions are welcome!
@@ -382,6 +409,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 - **Fluent UI**: [react.fluentui.dev](https://react.fluentui.dev/)
 - **Microsoft Graph**: [graph.microsoft.com](https://graph.microsoft.com)
+- **Component Roadmap**: [docs/COMPONENT_ROADMAP.md](./docs/COMPONENT_ROADMAP.md)
 - **Changelog**: [CHANGELOG.md](CHANGELOG.md)
 - **Publishing**: [PUBLISHING.md](PUBLISHING.md)