@susilkumar006/widgets-test 1.0.0

package/dist/context/navigation.d.ts

@@ -0,0 +1,10 @@
+import type { FacePeEvent, FacePeNavigationRequest } from '../types/index.js';
+/** 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;

package/dist/events/FacePeEventEmitter.d.cts

@@ -0,0 +1,59 @@
+/**
+ * Internal: the event emitter every SDK component emits through. Not exported
+ * from the package — hosts receive events through the components' `on…`
+ * props, which the components subscribe to their emitter.
+ */
+import type { CorrelationId, EntityId, FacePeEvent, FacePeEventHandler, FacePeEventMap } from '../types/index.cjs';
+import { type FacePeTelemetryReporter } from './telemetry.cjs';
+type EventName<TEvents extends FacePeEventMap> = keyof TEvents & string;
+/** A listener for one event type: the public `FacePeEventHandler` for that event. */
+export type FacePeListener<TEvents extends FacePeEventMap, K extends EventName<TEvents>> = FacePeEventHandler<FacePeEvent<K, TEvents[K]>>;
+/** Per-component values stamped on each event's meta, read at emit time. */
+export type FacePeEventContext = {
+    readonly entityId?: EntityId;
+};
+/**
+ * Typed publish/subscribe for one component's events.
+ *
+ * @typeParam TEvents - the component's event map (event name → payload type).
+ */
+export declare class FacePeEventEmitter<TEvents extends FacePeEventMap> {
+    private readonly source;
+    private readonly context;
+    private readonly report;
+    private listeners;
+    /**
+     * @param source - the emitting component's name, stamped on every event's meta.
+     * @param context - read on every emit, e.g. the component's current `entityId`.
+     * @param report - receives the telemetry record of every emitted event.
+     */
+    constructor(source: string, context?: () => FacePeEventContext, report?: FacePeTelemetryReporter);
+    /**
+     * Subscribes a listener to one event type. The same function subscribed
+     * twice is held once. Returns the matching unsubscribe function.
+     */
+    on<K extends EventName<TEvents>>(type: K, listener: FacePeListener<TEvents, K>): () => void;
+    /** Unsubscribes one listener; others on the same event are untouched. */
+    off<K extends EventName<TEvents>>(type: K, listener: FacePeListener<TEvents, K>): void;
+    /** How many listeners an event type has (for cleanup checks). */
+    listenerCount<K extends EventName<TEvents>>(type: K): number;
+    /** Removes every listener. */
+    clear(): void;
+    /**
+     * Wraps `payload` in the standard envelope and delivers it to every
+     * listener of `type`, in subscription order. A listener that throws is
+     * reported and skipped; the rest still run. The event is also reported to
+     * telemetry (without its payload). Returns the event delivered.
+     *
+     * @param correlationId - pass one to tie several events to one action
+     *   (e.g. a submit attempt's `submit` or `error`); a new one otherwise.
+     */
+    emit<K extends EventName<TEvents>>(type: K, payload: TEvents[K], correlationId?: CorrelationId): FacePeEvent<K, TEvents[K]>;
+    /**
+     * Delivers an event that already has its envelope — e.g. a component's
+     * `navigate` relayed to the provider, so both receive the very same event.
+     * Same isolation as `emit`. Not reported to telemetry: `emit` already did.
+     */
+    dispatch<K extends EventName<TEvents>>(event: FacePeEvent<K, TEvents[K]>): void;
+}
+export {};

package/dist/events/FacePeEventEmitter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Internal: the event emitter every SDK component emits through. Not exported
+ * from the package — hosts receive events through the components' `on…`
+ * props, which the components subscribe to their emitter.
+ */
+import type { CorrelationId, EntityId, FacePeEvent, FacePeEventHandler, FacePeEventMap } from '../types/index.js';
+import { type FacePeTelemetryReporter } from './telemetry.js';
+type EventName<TEvents extends FacePeEventMap> = keyof TEvents & string;
+/** A listener for one event type: the public `FacePeEventHandler` for that event. */
+export type FacePeListener<TEvents extends FacePeEventMap, K extends EventName<TEvents>> = FacePeEventHandler<FacePeEvent<K, TEvents[K]>>;
+/** Per-component values stamped on each event's meta, read at emit time. */
+export type FacePeEventContext = {
+    readonly entityId?: EntityId;
+};
+/**
+ * Typed publish/subscribe for one component's events.
+ *
+ * @typeParam TEvents - the component's event map (event name → payload type).
+ */
+export declare class FacePeEventEmitter<TEvents extends FacePeEventMap> {
+    private readonly source;
+    private readonly context;
+    private readonly report;
+    private listeners;
+    /**
+     * @param source - the emitting component's name, stamped on every event's meta.
+     * @param context - read on every emit, e.g. the component's current `entityId`.
+     * @param report - receives the telemetry record of every emitted event.
+     */
+    constructor(source: string, context?: () => FacePeEventContext, report?: FacePeTelemetryReporter);
+    /**
+     * Subscribes a listener to one event type. The same function subscribed
+     * twice is held once. Returns the matching unsubscribe function.
+     */
+    on<K extends EventName<TEvents>>(type: K, listener: FacePeListener<TEvents, K>): () => void;
+    /** Unsubscribes one listener; others on the same event are untouched. */
+    off<K extends EventName<TEvents>>(type: K, listener: FacePeListener<TEvents, K>): void;
+    /** How many listeners an event type has (for cleanup checks). */
+    listenerCount<K extends EventName<TEvents>>(type: K): number;
+    /** Removes every listener. */
+    clear(): void;
+    /**
+     * Wraps `payload` in the standard envelope and delivers it to every
+     * listener of `type`, in subscription order. A listener that throws is
+     * reported and skipped; the rest still run. The event is also reported to
+     * telemetry (without its payload). Returns the event delivered.
+     *
+     * @param correlationId - pass one to tie several events to one action
+     *   (e.g. a submit attempt's `submit` or `error`); a new one otherwise.
+     */
+    emit<K extends EventName<TEvents>>(type: K, payload: TEvents[K], correlationId?: CorrelationId): FacePeEvent<K, TEvents[K]>;
+    /**
+     * Delivers an event that already has its envelope — e.g. a component's
+     * `navigate` relayed to the provider, so both receive the very same event.
+     * Same isolation as `emit`. Not reported to telemetry: `emit` already did.
+     */
+    dispatch<K extends EventName<TEvents>>(event: FacePeEvent<K, TEvents[K]>): void;
+}
+export {};

package/dist/events/createCorrelationId.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Internal: correlation ids for SDK events. Not exported from the package.
+ */
+import type { CorrelationId } from '../types/index.cjs';
+/**
+ * A new, unique correlation id. Uses `crypto.randomUUID` and falls back where
+ * it is unavailable (pages not served over HTTPS, older runtimes).
+ */
+export declare function createCorrelationId(): CorrelationId;

package/dist/events/createCorrelationId.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Internal: correlation ids for SDK events. Not exported from the package.
+ */
+import type { CorrelationId } from '../types/index.js';
+/**
+ * A new, unique correlation id. Uses `crypto.randomUUID` and falls back where
+ * it is unavailable (pages not served over HTTPS, older runtimes).
+ */
+export declare function createCorrelationId(): CorrelationId;

package/dist/events/index.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Internal event infrastructure shared by SDK components. Not re-exported from
+ * src/index.ts, and package.json exports no path to it.
+ */
+export { FacePeEventEmitter, type FacePeEventContext, type FacePeListener } from './FacePeEventEmitter.cjs';
+export { useFacePeEmitter } from './useFacePeEmitter.cjs';
+export { createCorrelationId } from './createCorrelationId.cjs';
+export { FacePeTelemetryContext, telemetryOf, useFacePeTelemetryReporter, type FacePeTelemetryReporter, } from './telemetry.cjs';

package/dist/events/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Internal event infrastructure shared by SDK components. Not re-exported from
+ * src/index.ts, and package.json exports no path to it.
+ */
+export { FacePeEventEmitter, type FacePeEventContext, type FacePeListener } from './FacePeEventEmitter.js';
+export { useFacePeEmitter } from './useFacePeEmitter.js';
+export { createCorrelationId } from './createCorrelationId.js';
+export { FacePeTelemetryContext, telemetryOf, useFacePeTelemetryReporter, type FacePeTelemetryReporter, } from './telemetry.js';

package/dist/events/telemetry.d.cts

@@ -0,0 +1,11 @@
+import type { FacePeEvent, FacePeTelemetryEvent } from '../types/index.cjs';
+/**
+ * Internal: hands a telemetry record to the host's sink. The provider supplies
+ * one that reads its current `telemetry` prop and isolates a throwing sink;
+ * outside a provider it does nothing.
+ */
+export type FacePeTelemetryReporter = (event: FacePeTelemetryEvent) => void;
+export declare const FacePeTelemetryContext: import("react").Context<FacePeTelemetryReporter>;
+export declare function useFacePeTelemetryReporter(): FacePeTelemetryReporter;
+/** The telemetry record of a component event: its envelope minus the payload. */
+export declare function telemetryOf(event: FacePeEvent<string, unknown>): FacePeTelemetryEvent;

package/dist/events/telemetry.d.ts

@@ -0,0 +1,11 @@
+import type { FacePeEvent, FacePeTelemetryEvent } from '../types/index.js';
+/**
+ * Internal: hands a telemetry record to the host's sink. The provider supplies
+ * one that reads its current `telemetry` prop and isolates a throwing sink;
+ * outside a provider it does nothing.
+ */
+export type FacePeTelemetryReporter = (event: FacePeTelemetryEvent) => void;
+export declare const FacePeTelemetryContext: import("react").Context<FacePeTelemetryReporter>;
+export declare function useFacePeTelemetryReporter(): FacePeTelemetryReporter;
+/** The telemetry record of a component event: its envelope minus the payload. */
+export declare function telemetryOf(event: FacePeEvent<string, unknown>): FacePeTelemetryEvent;

package/dist/events/useFacePeEmitter.d.cts

@@ -0,0 +1,15 @@
+import type { FacePeEventMap } from '../types/index.cjs';
+import { FacePeEventEmitter, type FacePeEventContext } from './FacePeEventEmitter.cjs';
+import { type FacePeTelemetryReporter } from './telemetry.cjs';
+/**
+ * Internal: one emitter per component instance, created on first render and
+ * kept for the component's life. Components subscribe their host handlers in
+ * an effect (and unsubscribe in its cleanup), declared before any effect that
+ * emits, so listeners are in place for `ready`.
+ *
+ * @param context - read on every emit; pass a function over a ref so it sees
+ *   current values (e.g. `() => ({ entityId: entityRef.current })`).
+ * @param report - telemetry reporter; defaults to the nearest provider's (the
+ *   provider passes its own, as it sits above its own context).
+ */
+export declare function useFacePeEmitter<TEvents extends FacePeEventMap>(source: string, context?: () => FacePeEventContext, report?: FacePeTelemetryReporter): FacePeEventEmitter<TEvents>;

package/dist/events/useFacePeEmitter.d.ts

@@ -0,0 +1,15 @@
+import type { FacePeEventMap } from '../types/index.js';
+import { FacePeEventEmitter, type FacePeEventContext } from './FacePeEventEmitter.js';
+import { type FacePeTelemetryReporter } from './telemetry.js';
+/**
+ * Internal: one emitter per component instance, created on first render and
+ * kept for the component's life. Components subscribe their host handlers in
+ * an effect (and unsubscribe in its cleanup), declared before any effect that
+ * emits, so listeners are in place for `ready`.
+ *
+ * @param context - read on every emit; pass a function over a ref so it sees
+ *   current values (e.g. `() => ({ entityId: entityRef.current })`).
+ * @param report - telemetry reporter; defaults to the nearest provider's (the
+ *   provider passes its own, as it sits above its own context).
+ */
+export declare function useFacePeEmitter<TEvents extends FacePeEventMap>(source: string, context?: () => FacePeEventContext, report?: FacePeTelemetryReporter): FacePeEventEmitter<TEvents>;