@susilkumar006/widgets-test 1.0.0

package/dist/api/decoders.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Internal: runtime validation of gateway payloads — the trust boundary, the
+ * one place types are checked at runtime (architecture §7.5). Each decoder
+ * accepts the documented shape, ignores unknown fields (forward
+ * compatibility) and turns anything else into Failure INVAL_RESPONSE-style
+ * `INVALID_PAYLOAD`, never an exception.
+ */
+import type { FacePeAvatarInfo, FacePeFormValues, FacePePickerOption, FacePeTimelineItem } from '../types/index.js';
+import type { FacePeDecoder } from './FacePeApiClient.js';
+/** GET /orders/:id/timeline → `{ items: FacePeTimelineItem[] }`. */
+export declare const decodeTimeline: FacePeDecoder<readonly FacePeTimelineItem[]>;
+/** GET /locations/:id/categories → `{ options: FacePePickerOption[] }`. */
+export declare const decodePickerOptions: FacePeDecoder<readonly FacePePickerOption[]>;
+/** GET/PUT /orders/:id/customer → `{ name, email, notes }`. */
+export declare const decodeFormValues: FacePeDecoder<FacePeFormValues>;
+/** GET /avatars/:avatarId → `{ avatar }`. */
+export declare const decodeAvatar: FacePeDecoder<FacePeAvatarInfo>;
+/** GET /avatars → `{ avatars }`: the avatars the signed-in user may use. Entries that do not decode are skipped. */
+export declare const decodeAvatarList: FacePeDecoder<readonly FacePeAvatarInfo[]>;
+/**
+ * What POST /avatars/:avatarId/sessions returns: how to connect. The gateway
+ * never says where an avatar comes from, only the kind of connection:
+ * `room` (join a media room) or `stream` (a hosted stream).
+ */
+export type FacePeAvatarConnection = {
+    readonly type: 'stream';
+    readonly usageId: string | null;
+    readonly avatar: FacePeAvatarInfo;
+    readonly token: string;
+    readonly greeting: string | null;
+} | {
+    readonly type: 'room';
+    readonly usageId: string | null;
+    readonly avatar: FacePeAvatarInfo;
+    readonly url: string;
+    readonly token: string;
+};
+export declare const decodeAvatarConnection: FacePeDecoder<FacePeAvatarConnection>;
+/** Gateway paths, one per component (entity ids are path-encoded). */
+export declare const gatewayPath: {
+    readonly avatars: "/avatars";
+    readonly avatar: (avatarId: string) => string;
+    readonly avatarSessions: (avatarId: string) => string;
+    readonly endAvatarSession: (usageId: string) => string;
+    readonly timeline: (orderId: string) => string;
+    readonly pickerOptions: (locationId: string) => string;
+    readonly customer: (orderId: string) => string;
+};

package/dist/api/index.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Internal API-client infrastructure for SDK components. Not re-exported from
+ * src/index.ts, and package.json exports no path to it.
+ */
+export { FacePeApiClient, CORRELATION_HEADER, SDK_VERSION_HEADER, DEFAULT_TIMEOUT_MS, type FacePeApiClientOptions, type FacePeApiSettings, type FacePeDecoder, type FacePeQuery, type FacePeRequestOptions, } from './FacePeApiClient.cjs';
+export { FacePeApiContext, useFacePeApi } from './FacePeApiContext.cjs';
+export { decodeAvatar, decodeAvatarList, decodeAvatarConnection, decodeFormValues, decodePickerOptions, decodeTimeline, gatewayPath, type FacePeAvatarConnection, } from './decoders.cjs';
+export { useFacePeResource, type FacePeResource } from './useFacePeResource.cjs';

package/dist/api/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Internal API-client infrastructure for SDK components. Not re-exported from
+ * src/index.ts, and package.json exports no path to it.
+ */
+export { FacePeApiClient, CORRELATION_HEADER, SDK_VERSION_HEADER, DEFAULT_TIMEOUT_MS, type FacePeApiClientOptions, type FacePeApiSettings, type FacePeDecoder, type FacePeQuery, type FacePeRequestOptions, } from './FacePeApiClient.js';
+export { FacePeApiContext, useFacePeApi } from './FacePeApiContext.js';
+export { decodeAvatar, decodeAvatarList, decodeAvatarConnection, decodeFormValues, decodePickerOptions, decodeTimeline, gatewayPath, type FacePeAvatarConnection, } from './decoders.js';
+export { useFacePeResource, type FacePeResource } from './useFacePeResource.js';

package/dist/api/json.d.cts

@@ -0,0 +1,5 @@
+import type { JsonObject, JsonValue } from '../types/index.cjs';
+/** True when `value` is valid JSON data (what `JSON.parse` can produce). */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+/** True for a JSON object (not an array, not null). */
+export declare function isJsonObject(value: JsonValue | undefined): value is JsonObject;

package/dist/api/json.d.ts

@@ -0,0 +1,5 @@
+import type { JsonObject, JsonValue } from '../types/index.js';
+/** True when `value` is valid JSON data (what `JSON.parse` can produce). */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+/** True for a JSON object (not an array, not null). */
+export declare function isJsonObject(value: JsonValue | undefined): value is JsonObject;

package/dist/api/useFacePeResource.d.cts

@@ -0,0 +1,21 @@
+import type { FacePeError } from '../types/index.cjs';
+import type { FacePeDecoder } from './FacePeApiClient.cjs';
+/** What a component knows about data it fetches through the gateway. */
+export type FacePeResource<T> = {
+    readonly status: 'idle';
+} | {
+    readonly status: 'loading';
+} | {
+    readonly status: 'ready';
+    readonly data: T;
+} | {
+    readonly status: 'failed';
+    readonly error: FacePeError;
+};
+/**
+ * Internal: GETs `path` through the provider's API client and decodes it.
+ * `path` null means "nothing to fetch" (the host passed the data itself).
+ * A new path cancels the request in flight; so does unmounting. The component
+ * reports a `failed` state through its own `error` event.
+ */
+export declare function useFacePeResource<T>(path: string | null, decode: FacePeDecoder<T>): FacePeResource<T>;

package/dist/api/useFacePeResource.d.ts

@@ -0,0 +1,21 @@
+import type { FacePeError } from '../types/index.js';
+import type { FacePeDecoder } from './FacePeApiClient.js';
+/** What a component knows about data it fetches through the gateway. */
+export type FacePeResource<T> = {
+    readonly status: 'idle';
+} | {
+    readonly status: 'loading';
+} | {
+    readonly status: 'ready';
+    readonly data: T;
+} | {
+    readonly status: 'failed';
+    readonly error: FacePeError;
+};
+/**
+ * Internal: GETs `path` through the provider's API client and decodes it.
+ * `path` null means "nothing to fetch" (the host passed the data itself).
+ * A new path cancels the request in flight; so does unmounting. The component
+ * reports a `failed` state through its own `error` event.
+ */
+export declare function useFacePeResource<T>(path: string | null, decode: FacePeDecoder<T>): FacePeResource<T>;

package/dist/components/Avatar/FacePeAvatar.d.cts

@@ -0,0 +1,23 @@
+import type { FacePeAvatarEvents, FacePeAvatarHandle } from '../../types/index.cjs';
+/**
+ * The FacePe avatar conversation, embedded in the host's page: the same
+ * avatar, trained prompt, voice and features as on the FacePe website.
+ *
+ * Talks to the avatar_id given here or on the provider. The user whose keys
+ * the host uses must have that avatar assigned (super admin → company → user
+ * → avatar); otherwise the component reports `FORBIDDEN` through `onError`.
+ * Without an avatar_id it loads the user's assigned avatars and lets the user
+ * choose (the first is selected), so the keys alone are enough.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePeAvatar: import("react").ForwardRefExoticComponent<import("../../index.cjs").FacePeConfig & import("../../index.cjs").FacePeEventHandlers<FacePeAvatarEvents> & {
+    readonly slots?: import("../../index.cjs").FacePeSlots<import("../../index.cjs").FacePeAvatarSlots> | undefined;
+    readonly emphasis?: import("../../index.cjs").FacePeEmphasis;
+    readonly size?: import("../../index.cjs").FacePeSize;
+} & {
+    readonly avatarId?: string;
+    readonly language?: string;
+    readonly autoStart?: boolean;
+    readonly captions?: boolean;
+} & import("react").RefAttributes<FacePeAvatarHandle>>;

package/dist/components/Avatar/FacePeAvatar.d.ts

@@ -0,0 +1,23 @@
+import type { FacePeAvatarEvents, FacePeAvatarHandle } from '../../types/index.js';
+/**
+ * The FacePe avatar conversation, embedded in the host's page: the same
+ * avatar, trained prompt, voice and features as on the FacePe website.
+ *
+ * Talks to the avatar_id given here or on the provider. The user whose keys
+ * the host uses must have that avatar assigned (super admin → company → user
+ * → avatar); otherwise the component reports `FORBIDDEN` through `onError`.
+ * Without an avatar_id it loads the user's assigned avatars and lets the user
+ * choose (the first is selected), so the keys alone are enough.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePeAvatar: import("react").ForwardRefExoticComponent<import("../../index.js").FacePeConfig & import("../../index.js").FacePeEventHandlers<FacePeAvatarEvents> & {
+    readonly slots?: import("../../index.js").FacePeSlots<import("../../index.js").FacePeAvatarSlots> | undefined;
+    readonly emphasis?: import("../../index.js").FacePeEmphasis;
+    readonly size?: import("../../index.js").FacePeSize;
+} & {
+    readonly avatarId?: string;
+    readonly language?: string;
+    readonly autoStart?: boolean;
+    readonly captions?: boolean;
+} & import("react").RefAttributes<FacePeAvatarHandle>>;

package/dist/components/Avatar/engines.d.cts

@@ -0,0 +1,30 @@
+/**
+ * Internal: the two avatar engines behind <FacePeAvatar>, as on the FacePe
+ * website — Anam's hosted avatar, or FacePe's self-hosted agent in a LiveKit
+ * room. Each is loaded with import() only when a conversation starts, so a
+ * host pays for it (in its own bundle, as a separate chunk) only when used.
+ */
+import type { FacePeAvatarConnection } from '../../api/index.cjs';
+import type { FacePeTranscriptLine } from '../../types/index.cjs';
+export type EngineHandlers = {
+    /** The avatar's picture is playing. */
+    onLive(): void;
+    onTranscript(line: FacePeTranscriptLine): void;
+    onOrder(items: readonly {
+        name: string;
+        qty: number;
+    }[]): void;
+    /** The stream dropped (not called after end()). */
+    onDisconnected(): void;
+};
+export type EngineSession = {
+    end(): Promise<void>;
+    setMuted(muted: boolean): Promise<void>;
+};
+/**
+ * Starts fetching the connection libraries; safe to call any number of times.
+ * Which one an avatar needs is only known when its session starts, so both
+ * are fetched (each once). A failed preload is retried by connectEngine.
+ */
+export declare function preloadEngines(): void;
+export declare function connectEngine(video: HTMLVideoElement, conn: FacePeAvatarConnection, on: EngineHandlers): Promise<EngineSession>;

package/dist/components/Avatar/engines.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Internal: the two avatar engines behind <FacePeAvatar>, as on the FacePe
+ * website — Anam's hosted avatar, or FacePe's self-hosted agent in a LiveKit
+ * room. Each is loaded with import() only when a conversation starts, so a
+ * host pays for it (in its own bundle, as a separate chunk) only when used.
+ */
+import type { FacePeAvatarConnection } from '../../api/index.js';
+import type { FacePeTranscriptLine } from '../../types/index.js';
+export type EngineHandlers = {
+    /** The avatar's picture is playing. */
+    onLive(): void;
+    onTranscript(line: FacePeTranscriptLine): void;
+    onOrder(items: readonly {
+        name: string;
+        qty: number;
+    }[]): void;
+    /** The stream dropped (not called after end()). */
+    onDisconnected(): void;
+};
+export type EngineSession = {
+    end(): Promise<void>;
+    setMuted(muted: boolean): Promise<void>;
+};
+/**
+ * Starts fetching the connection libraries; safe to call any number of times.
+ * Which one an avatar needs is only known when its session starts, so both
+ * are fetched (each once). A failed preload is retried by connectEngine.
+ */
+export declare function preloadEngines(): void;
+export declare function connectEngine(video: HTMLVideoElement, conn: FacePeAvatarConnection, on: EngineHandlers): Promise<EngineSession>;

package/dist/components/Avatar/index.d.cts

@@ -0,0 +1 @@
+export { FacePeAvatar } from './FacePeAvatar.cjs';

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

@@ -0,0 +1 @@
+export { FacePeAvatar } from './FacePeAvatar.js';

package/dist/components/Form/FacePeForm.d.cts

@@ -0,0 +1,19 @@
+import type { FacePeFormEvents, FacePeFormHandle, FacePeFormValues } from '../../types/index.cjs';
+/**
+ * A basic FacePe form: name, email and notes, with required-field validation.
+ *
+ * Reads shared configuration from the nearest `<FacePeProvider>`; its own
+ * `mode`, `density` and `locale` props override the provider's. In `view`
+ * mode (the default) the fields are read-only and there is no submit action.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePeForm: import("react").ForwardRefExoticComponent<import("../../index.cjs").FacePeConfig & import("../../index.cjs").FacePeEventHandlers<FacePeFormEvents> & {
+    readonly slots?: import("../../index.cjs").FacePeSlots<import("../../index.cjs").FacePeFormSlots> | undefined;
+    readonly emphasis?: import("../../index.cjs").FacePeEmphasis;
+    readonly size?: import("../../index.cjs").FacePeSize;
+} & {
+    readonly initialValues?: Partial<FacePeFormValues>;
+    readonly submitAction?: import("../../index.cjs").FacePeFormSubmitAction;
+    readonly variant?: import("../../index.cjs").FacePeFormVariant;
+} & import("react").RefAttributes<FacePeFormHandle>>;

package/dist/components/Form/FacePeForm.d.ts

@@ -0,0 +1,19 @@
+import type { FacePeFormEvents, FacePeFormHandle, FacePeFormValues } from '../../types/index.js';
+/**
+ * A basic FacePe form: name, email and notes, with required-field validation.
+ *
+ * Reads shared configuration from the nearest `<FacePeProvider>`; its own
+ * `mode`, `density` and `locale` props override the provider's. In `view`
+ * mode (the default) the fields are read-only and there is no submit action.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePeForm: import("react").ForwardRefExoticComponent<import("../../index.js").FacePeConfig & import("../../index.js").FacePeEventHandlers<FacePeFormEvents> & {
+    readonly slots?: import("../../index.js").FacePeSlots<import("../../index.js").FacePeFormSlots> | undefined;
+    readonly emphasis?: import("../../index.js").FacePeEmphasis;
+    readonly size?: import("../../index.js").FacePeSize;
+} & {
+    readonly initialValues?: Partial<FacePeFormValues>;
+    readonly submitAction?: import("../../index.js").FacePeFormSubmitAction;
+    readonly variant?: import("../../index.js").FacePeFormVariant;
+} & import("react").RefAttributes<FacePeFormHandle>>;

package/dist/components/Form/index.d.cts

@@ -0,0 +1 @@
+export { FacePeForm } from './FacePeForm.cjs';

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

@@ -0,0 +1 @@
+export { FacePeForm } from './FacePeForm.js';

package/dist/components/Picker/FacePePicker.d.cts

@@ -0,0 +1,22 @@
+import type { FacePePickerEvents, FacePePickerHandle, FacePePickerOption } from '../../types/index.cjs';
+/**
+ * A single-choice FacePe picker built on a native radio group, so arrow keys,
+ * focus and the selected/disabled states work and are announced natively.
+ *
+ * Reads shared configuration from the nearest `<FacePeProvider>`; its own
+ * `mode`, `density`, `locale` and `featureFlags` props override the provider's.
+ * In `view` mode (the default) the current selection is shown but cannot be
+ * changed.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePePicker: import("react").ForwardRefExoticComponent<import("../../index.cjs").FacePeConfig & import("../../index.cjs").FacePeEventHandlers<FacePePickerEvents> & {
+    readonly slots?: import("../../index.cjs").FacePeSlots<import("../../index.cjs").FacePePickerSlots> | undefined;
+    readonly emphasis?: import("../../index.cjs").FacePeEmphasis;
+    readonly size?: import("../../index.cjs").FacePeSize;
+} & {
+    readonly label?: string;
+    readonly options?: readonly FacePePickerOption[];
+    readonly defaultValue?: string;
+    readonly variant?: import("../../index.cjs").FacePePickerVariant;
+} & import("react").RefAttributes<FacePePickerHandle>>;

package/dist/components/Picker/FacePePicker.d.ts

@@ -0,0 +1,22 @@
+import type { FacePePickerEvents, FacePePickerHandle, FacePePickerOption } from '../../types/index.js';
+/**
+ * A single-choice FacePe picker built on a native radio group, so arrow keys,
+ * focus and the selected/disabled states work and are announced natively.
+ *
+ * Reads shared configuration from the nearest `<FacePeProvider>`; its own
+ * `mode`, `density`, `locale` and `featureFlags` props override the provider's.
+ * In `view` mode (the default) the current selection is shown but cannot be
+ * changed.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePePicker: import("react").ForwardRefExoticComponent<import("../../index.js").FacePeConfig & import("../../index.js").FacePeEventHandlers<FacePePickerEvents> & {
+    readonly slots?: import("../../index.js").FacePeSlots<import("../../index.js").FacePePickerSlots> | undefined;
+    readonly emphasis?: import("../../index.js").FacePeEmphasis;
+    readonly size?: import("../../index.js").FacePeSize;
+} & {
+    readonly label?: string;
+    readonly options?: readonly FacePePickerOption[];
+    readonly defaultValue?: string;
+    readonly variant?: import("../../index.js").FacePePickerVariant;
+} & import("react").RefAttributes<FacePePickerHandle>>;

package/dist/components/Picker/index.d.cts

@@ -0,0 +1 @@
+export { FacePePicker } from './FacePePicker.cjs';

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

@@ -0,0 +1 @@
+export { FacePePicker } from './FacePePicker.js';

package/dist/components/Placement/FacePeOverlay.d.cts

@@ -0,0 +1,13 @@
+import type { FacePeOverlayProps } from '../../types/index.cjs';
+/**
+ * Overlay display mode: shows a FacePe component over the page, as a centred
+ * modal or (`variant="drawer"`) a side drawer. Both are a modal dialog built on
+ * the native `<dialog>`, so focus stays inside, Escape is handled and the page
+ * behind is inert. The host owns `open`; Escape only asks, via `onClose`.
+ *
+ * @example
+ * <FacePeOverlay open={open} label="Update details" onClose={() => setOpen(false)}>
+ *   <FacePeForm onCancel={() => setOpen(false)} />
+ * </FacePeOverlay>
+ */
+export declare function FacePeOverlay({ open, label, variant, onClose, children }: FacePeOverlayProps): import("react").JSX.Element;

package/dist/components/Placement/FacePeOverlay.d.ts

@@ -0,0 +1,13 @@
+import type { FacePeOverlayProps } from '../../types/index.js';
+/**
+ * Overlay display mode: shows a FacePe component over the page, as a centred
+ * modal or (`variant="drawer"`) a side drawer. Both are a modal dialog built on
+ * the native `<dialog>`, so focus stays inside, Escape is handled and the page
+ * behind is inert. The host owns `open`; Escape only asks, via `onClose`.
+ *
+ * @example
+ * <FacePeOverlay open={open} label="Update details" onClose={() => setOpen(false)}>
+ *   <FacePeForm onCancel={() => setOpen(false)} />
+ * </FacePeOverlay>
+ */
+export declare function FacePeOverlay({ open, label, variant, onClose, children }: FacePeOverlayProps): import("react").JSX.Element;

package/dist/components/Placement/FacePePage.d.cts

@@ -0,0 +1,10 @@
+import type { FacePePageProps } from '../../types/index.cjs';
+/**
+ * Page display mode: shows a FacePe component as a full view filling the
+ * container the host gives it. The component inside is unchanged; titles,
+ * breadcrumbs and navigation stay with the host.
+ *
+ * @example
+ * <Route path="/schedule" element={<FacePePage><FacePeTimeline items={items} /></FacePePage>} />
+ */
+export declare function FacePePage({ children }: FacePePageProps): import("react").JSX.Element;

package/dist/components/Placement/FacePePage.d.ts

@@ -0,0 +1,10 @@
+import type { FacePePageProps } from '../../types/index.js';
+/**
+ * Page display mode: shows a FacePe component as a full view filling the
+ * container the host gives it. The component inside is unchanged; titles,
+ * breadcrumbs and navigation stay with the host.
+ *
+ * @example
+ * <Route path="/schedule" element={<FacePePage><FacePeTimeline items={items} /></FacePePage>} />
+ */
+export declare function FacePePage({ children }: FacePePageProps): import("react").JSX.Element;

package/dist/components/Placement/index.d.cts

@@ -0,0 +1,2 @@
+export { FacePePage } from './FacePePage.cjs';
+export { FacePeOverlay } from './FacePeOverlay.cjs';

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

@@ -0,0 +1,2 @@
+export { FacePePage } from './FacePePage.js';
+export { FacePeOverlay } from './FacePeOverlay.js';

package/dist/components/Timeline/FacePeTimeline.d.cts

@@ -0,0 +1,23 @@
+import type { FacePeTimelineEvents, FacePeTimelineHandle, FacePeTimelineItem } from '../../types/index.cjs';
+/**
+ * A chronological FacePe timeline: each item shows a status marker and label,
+ * title, time, and optional description and metadata.
+ *
+ * Items become selectable buttons when `onSelect` is passed; otherwise the
+ * timeline is a plain, read-only list. Reads shared configuration from the
+ * nearest `<FacePeProvider>`; its own `density`, `locale` and `featureFlags`
+ * props override the provider's. `mode` has no effect: a timeline has
+ * nothing to edit, and selecting an item is viewing, not editing.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePeTimeline: import("react").ForwardRefExoticComponent<import("../../index.cjs").FacePeConfig & import("../../index.cjs").FacePeEventHandlers<FacePeTimelineEvents> & {
+    readonly slots?: import("../../index.cjs").FacePeSlots<import("../../index.cjs").FacePeTimelineSlots> | undefined;
+    readonly emphasis?: import("../../index.cjs").FacePeEmphasis;
+    readonly size?: import("../../index.cjs").FacePeSize;
+} & {
+    readonly items?: readonly FacePeTimelineItem[];
+    readonly label?: string;
+    readonly sort?: "none" | "ascending" | "descending";
+    readonly loading?: boolean;
+} & import("react").RefAttributes<FacePeTimelineHandle>>;

package/dist/components/Timeline/FacePeTimeline.d.ts

@@ -0,0 +1,23 @@
+import type { FacePeTimelineEvents, FacePeTimelineHandle, FacePeTimelineItem } from '../../types/index.js';
+/**
+ * A chronological FacePe timeline: each item shows a status marker and label,
+ * title, time, and optional description and metadata.
+ *
+ * Items become selectable buttons when `onSelect` is passed; otherwise the
+ * timeline is a plain, read-only list. Reads shared configuration from the
+ * nearest `<FacePeProvider>`; its own `density`, `locale` and `featureFlags`
+ * props override the provider's. `mode` has no effect: a timeline has
+ * nothing to edit, and selecting an item is viewing, not editing.
+ *
+ * Styles ship separately: import "@facepe/widgets/styles.css" once in the host.
+ */
+export declare const FacePeTimeline: import("react").ForwardRefExoticComponent<import("../../index.js").FacePeConfig & import("../../index.js").FacePeEventHandlers<FacePeTimelineEvents> & {
+    readonly slots?: import("../../index.js").FacePeSlots<import("../../index.js").FacePeTimelineSlots> | undefined;
+    readonly emphasis?: import("../../index.js").FacePeEmphasis;
+    readonly size?: import("../../index.js").FacePeSize;
+} & {
+    readonly items?: readonly FacePeTimelineItem[];
+    readonly label?: string;
+    readonly sort?: "none" | "ascending" | "descending";
+    readonly loading?: boolean;
+} & import("react").RefAttributes<FacePeTimelineHandle>>;

package/dist/components/Timeline/index.d.cts

@@ -0,0 +1 @@
+export { FacePeTimeline } from './FacePeTimeline.cjs';

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

@@ -0,0 +1 @@
+export { FacePeTimeline } from './FacePeTimeline.js';

package/dist/components/shared/FacePeErrorBoundary.d.cts

@@ -0,0 +1,28 @@
+import { Component, type ReactNode } from 'react';
+import type { EntityId, FacePeError, FacePeEvent, FacePeEventHandler, FacePeFallbackContext, FacePeSlot } from '../../types/index.cjs';
+type Props = {
+    /** The wrapped component's name, stamped on the error event. */
+    readonly source: string;
+    readonly entityId?: EntityId;
+    readonly onError?: FacePeEventHandler<FacePeEvent<'error', FacePeError>>;
+    readonly fallback?: FacePeSlot<FacePeFallbackContext>;
+    readonly children?: ReactNode;
+};
+type State = {
+    readonly error: FacePeError | null;
+};
+/**
+ * Internal: keeps a failing FacePe component from taking the host's React tree
+ * down with it. Reports `error` (code RENDER_FAILED) through the same event
+ * envelope as every other event, then shows the host's `fallback` slot, or a
+ * short message. To retry, the host remounts the component (e.g. a new `key`).
+ */
+export declare class FacePeErrorBoundary extends Component<Props, State> {
+    state: State;
+    private readonly events;
+    constructor(props: Props);
+    static getDerivedStateFromError(): State;
+    componentDidCatch(): void;
+    render(): ReactNode;
+}
+export {};

package/dist/components/shared/FacePeErrorBoundary.d.ts

@@ -0,0 +1,28 @@
+import { Component, type ReactNode } from 'react';
+import type { EntityId, FacePeError, FacePeEvent, FacePeEventHandler, FacePeFallbackContext, FacePeSlot } from '../../types/index.js';
+type Props = {
+    /** The wrapped component's name, stamped on the error event. */
+    readonly source: string;
+    readonly entityId?: EntityId;
+    readonly onError?: FacePeEventHandler<FacePeEvent<'error', FacePeError>>;
+    readonly fallback?: FacePeSlot<FacePeFallbackContext>;
+    readonly children?: ReactNode;
+};
+type State = {
+    readonly error: FacePeError | null;
+};
+/**
+ * Internal: keeps a failing FacePe component from taking the host's React tree
+ * down with it. Reports `error` (code RENDER_FAILED) through the same event
+ * envelope as every other event, then shows the host's `fallback` slot, or a
+ * short message. To retry, the host remounts the component (e.g. a new `key`).
+ */
+export declare class FacePeErrorBoundary extends Component<Props, State> {
+    state: State;
+    private readonly events;
+    constructor(props: Props);
+    static getDerivedStateFromError(): State;
+    componentDidCatch(): void;
+    render(): ReactNode;
+}
+export {};

package/dist/components/shared/surface.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Internal: the root classes every FacePe component shares — the token
+ * defaults plus the L2 `emphasis` and `size` variants.
+ */
+import type { FacePeEmphasis, FacePeSize } from '../../types/index.cjs';
+export declare function surfaceClass(emphasis?: FacePeEmphasis, size?: FacePeSize): string;

package/dist/components/shared/surface.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal: the root classes every FacePe component shares — the token
+ * defaults plus the L2 `emphasis` and `size` variants.
+ */
+import type { FacePeEmphasis, FacePeSize } from '../../types/index.js';
+export declare function surfaceClass(emphasis?: FacePeEmphasis, size?: FacePeSize): string;

package/dist/context/FacePeContext.d.cts

@@ -0,0 +1,22 @@
+import type { FacePeContextValue, FacePeProviderProps } from '../types/index.cjs';
+/**
+ * Makes the host's FacePe configuration available to every FacePe component
+ * rendered below it, and gives them an API client scoped to this provider.
+ *
+ * @example
+ * <FacePeProvider
+ *   config={{ locale: 'en-IN', density: 'compact' }}
+ *   apiBaseUrl="https://api.example.com/api/v1"
+ *   getToken={({ forceRefresh }) => auth.accessToken({ forceRefresh })}
+ *   onSessionExpired={() => auth.signIn()}
+ * >
+ *   <App />
+ * </FacePeProvider>
+ */
+export declare function FacePeProvider({ config, children, ...settings }: FacePeProviderProps): import("react").JSX.Element;
+/**
+ * Reads the configuration from the nearest `<FacePeProvider>`.
+ *
+ * @throws Error when called outside a `<FacePeProvider>`.
+ */
+export declare function useFacePe(): FacePeContextValue;

package/dist/context/FacePeContext.d.ts

@@ -0,0 +1,22 @@
+import type { FacePeContextValue, FacePeProviderProps } from '../types/index.js';
+/**
+ * Makes the host's FacePe configuration available to every FacePe component
+ * rendered below it, and gives them an API client scoped to this provider.
+ *
+ * @example
+ * <FacePeProvider
+ *   config={{ locale: 'en-IN', density: 'compact' }}
+ *   apiBaseUrl="https://api.example.com/api/v1"
+ *   getToken={({ forceRefresh }) => auth.accessToken({ forceRefresh })}
+ *   onSessionExpired={() => auth.signIn()}
+ * >
+ *   <App />
+ * </FacePeProvider>
+ */
+export declare function FacePeProvider({ config, children, ...settings }: FacePeProviderProps): import("react").JSX.Element;
+/**
+ * Reads the configuration from the nearest `<FacePeProvider>`.
+ *
+ * @throws Error when called outside a `<FacePeProvider>`.
+ */
+export declare function useFacePe(): FacePeContextValue;

package/dist/context/avatar.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Internal: the provider's `avatarId`, the default for `<FacePeAvatar>`.
+ * Kept apart from the public context so `FacePeContextValue` is unchanged.
+ */
+export declare const FacePeAvatarIdContext: import("react").Context<string | undefined>;
+export declare function useFacePeAvatarId(): string | undefined;

package/dist/context/avatar.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal: the provider's `avatarId`, the default for `<FacePeAvatar>`.
+ * Kept apart from the public context so `FacePeContextValue` is unchanged.
+ */
+export declare const FacePeAvatarIdContext: import("react").Context<string | undefined>;
+export declare function useFacePeAvatarId(): string | undefined;

package/dist/context/index.d.cts

@@ -0,0 +1,5 @@
+/**
+ * The public context API of @facepe/widgets. The context object itself stays
+ * internal: hosts use the provider, components use the hook.
+ */
+export { FacePeProvider, useFacePe } from './FacePeContext.cjs';

package/dist/context/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The public context API of @facepe/widgets. The context object itself stays
+ * internal: hosts use the provider, components use the hook.
+ */
+export { FacePeProvider, useFacePe } from './FacePeContext.js';

package/dist/context/navigation.d.cts

@@ -0,0 +1,10 @@
+import type { FacePeEvent, FacePeNavigationRequest } from '../types/index.cjs';
+/** Hands a component's `navigate` event to the provider's `onNavigate`. */
+export type FacePeNavigationRelay = (event: FacePeEvent<'navigate', FacePeNavigationRequest>) => void;
+/**
+ * Internal: the navigation side of the context bridge. Components emit
+ * `navigate` to their own handler and relay the same event here; the host's
+ * router does the navigating. Not exported from the package.
+ */
+export declare const FacePeNavigationContext: import("react").Context<FacePeNavigationRelay>;
+export declare function useFacePeNavigationRelay(): FacePeNavigationRelay;