@devsym/graph-toolkit-react 1.0.0-next.10 → 1.0.0-next.11

package/AGENTS.md

@@ -141,7 +141,8 @@ export class MyProvider implements IProvider {
 | --- | --- | --- |
 | Current user profile (`userId="me"`) | `User.Read` | Required for basic profile fields |
 | Other user profile (`userId="{id/upn}"`) | `User.ReadBasic.All` | May require admin consent |
-| PeoplePicker focus suggestions | `People.Read` | Required for the initial `/me/people` suggestions shown before typing |
+| People default suggestions | `User.ReadBasic.All` | Used for the initial `/users` directory list when no explicit people source is provided |
+| PeoplePicker focus suggestions | `User.ReadBasic.All` | Uses the initial `/users` directory list shown before typing |
 | Presence (`showPresence`) | `Presence.Read` | UI still renders without presence |
 | Profile photo (`fetchImage`) | `User.Read` | Falls back to initials if unavailable |
 

package/dist/components/People/People.d.ts

@@ -0,0 +1,16 @@
+/**
+ * People component - Display a compact group of people as overlapping avatars
+ */
+import React from 'react';
+import { PeopleProps } from './People.types';
+/**
+ * `People` renders a compact avatar strip similar to the MGT `mgt-people` control.
+ *
+ * The component can render a supplied list of people, resolve a list of `userIds`, load
+ * group members, or default to tenant directory users from `/users`.
+ *
+ * @param props - Avatar group configuration and people-loading options
+ * @returns A compact avatar group, a loading spinner, or `null` when no people are available
+ */
+export declare const People: React.FC<PeopleProps>;
+//# sourceMappingURL=People.d.ts.map

package/dist/components/People/People.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"People.d.ts","sourceRoot":"","sources":["../../../src/components/People/People.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA6C3D;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAwCxC,CAAC"}

package/dist/components/People/People.types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * People component types
+ */
+import type { AvatarGroupProps } from '@fluentui/react-components';
+import type { PeopleSearchResult } from '../../providers/IPersonDataProvider';
+/**
+ * A person entry rendered by the {@link People} component.
+ *
+ * This extends the base people search result shape with optional presence fields used
+ * for avatar badges when {@link PeopleProps.showPresence} is enabled.
+ */
+export interface PeoplePerson extends PeopleSearchResult {
+    /**
+     * Current presence activity when available.
+     */
+    presenceActivity?: string | null;
+    /**
+     * Current presence availability when available.
+     */
+    presenceAvailability?: string | null;
+}
+/**
+ * Props for the {@link People} component.
+ */
+export interface PeopleProps extends Omit<AvatarGroupProps, 'children'> {
+    /**
+     * A pre-resolved list of people to render.
+     *
+     * When provided, the component skips list discovery and renders these people directly.
+     */
+    people?: PeoplePerson[];
+    /**
+     * A list of user identifiers to resolve and render.
+     *
+     * Values can be Microsoft Graph user IDs, UPNs, email addresses, or `"me"`.
+     */
+    userIds?: string[];
+    /**
+     * The ID of a Microsoft Entra ID group whose direct user members should be rendered.
+     */
+    groupId?: string;
+    /**
+     * Maximum number of visible avatars before the remaining people are shown in overflow.
+     *
+     * Defaults to `3`, matching the MGT `mgt-people` control.
+     */
+    showMax?: number;
+    /**
+     * Whether presence badges should be shown on each avatar.
+     *
+     * Presence is loaded when the active provider and granted scopes support it.
+     */
+    showPresence?: boolean;
+}
+//# sourceMappingURL=People.types.d.ts.map

package/dist/components/People/People.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"People.types.d.ts","sourceRoot":"","sources":["../../../src/components/People/People.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IACrE;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/components/People/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * People component exports
+ */
+export { People } from './People';
+export type { PeoplePerson, PeopleProps } from './People.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/People/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/People/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/usePeopleList.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Hook to load a list of people from Microsoft Graph or a compatible provider
+ */
+import type { PeoplePerson } from '../components/People/People.types';
+/**
+ * Options for the {@link usePeopleList} hook.
+ */
+export interface UsePeopleListOptions {
+    /**
+     * Pre-resolved people to render directly.
+     */
+    people?: PeoplePerson[];
+    /**
+     * User identifiers to resolve into person entries.
+     */
+    userIds?: string[];
+    /**
+     * Group ID whose direct members should be loaded.
+     */
+    groupId?: string;
+    /**
+     * Maximum number of people to load for Graph-backed list queries.
+     *
+     * Ignored when {@link userIds} or direct {@link people} are provided.
+     */
+    maxPeople?: number;
+    /**
+     * Whether presence information should be loaded when supported.
+     */
+    showPresence?: boolean;
+}
+/**
+ * Result returned by the {@link usePeopleList} hook.
+ */
+export interface UsePeopleListResult {
+    /**
+     * The resolved list of people.
+     */
+    people: PeoplePerson[];
+    /**
+     * Whether loading is currently in progress.
+     */
+    loading: boolean;
+    /**
+     * The most recent list-loading error, if any.
+     */
+    error: Error | null;
+}
+/**
+ * Hook to load a compact people list for the {@link People} component.
+ *
+ * Resolution order matches the component inputs:
+ * 1. `people` (render directly)
+ * 2. `userIds` (resolve each identifier)
+ * 3. `groupId` (load direct group members)
+ * 4. default tenant directory users (`/users`)
+ *
+ * @param options - Configuration for how people should be resolved
+ * @returns The resolved people, loading state, and any list-level error
+ */
+export declare const usePeopleList: (options?: UsePeopleListOptions) => UsePeopleListResult;
+//# sourceMappingURL=usePeopleList.d.ts.map

package/dist/hooks/usePeopleList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePeopleList.d.ts","sourceRoot":"","sources":["../../src/hooks/usePeopleList.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAOtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAwCD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,oBAAoB,KAAG,mBA4N9D,CAAC"}

package/dist/hooks/usePeopleSearch.d.ts

@@ -32,7 +32,7 @@ export interface UsePeopleSearchResult {
  * When used with a {@link MockProvider} the search is performed locally against mock data.
  * With a real provider the hook queries the Microsoft Graph `/users` endpoint using
  * `$search` with `ConsistencyLevel: eventual`. When `loadInitialResults` is enabled and
- * the query is empty, it instead loads initial suggestions from `/me/people`.
+ * the query is empty, it instead loads the first tenant directory users from `/users`.
  *
  * @param query - The search query string
  * @param options - Optional configuration

package/dist/hooks/usePeopleSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePeopleSearch.d.ts","sourceRoot":"","sources":["../../src/hooks/usePeopleSearch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAA0B,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE9F,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AA8DD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,UAAU,sBAAsB,KAC/B,qBA+FF,CAAC"}
+{"version":3,"file":"usePeopleSearch.d.ts","sourceRoot":"","sources":["../../src/hooks/usePeopleSearch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAA0B,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE9F,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAkBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,UAAU,sBAAsB,KAC/B,qBA+FF,CAAC"}

package/dist/hooks/usePersonData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePersonData.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersonData.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAYlE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAwCD;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,oBAAoB,KAAG,UA2O7D,CAAC"}
+{"version":3,"file":"usePersonData.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersonData.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAalE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAYD;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,oBAAoB,KAAG,UAmP7D,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@
  * React components for Microsoft Graph powered by Fluent UI
  */
 export * from './components/Person';
+export * from './components/People';
 export * from './components/PeoplePicker';
 export * from './providers/IProvider';
 export * from './providers/IPersonDataProvider';
@@ -13,5 +14,6 @@ export * from './providers/MsalBrowserProvider';
 export * from './providers/TeamsHostedProvider';
 export * from './hooks/useGraphClient';
 export * from './hooks/usePersonData';
+export * from './hooks/usePeopleList';
 export * from './hooks/usePeopleSearch';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAGhD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAGhD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}