@elliemae/pui-app-sdk 6.0.0-alpha.2 → 6.0.0-alpha.4

package/dist/types/lib/utils/micro-frontend/tests/utils.d.ts

@@ -0,0 +1,39 @@
+export type SSFMessage = {
+    data: {
+        requestId: number;
+        type: string;
+        body: {
+            eventFeedback: boolean;
+            objectId: string;
+            functionName: string;
+            functionParams?: Array<unknown>;
+        };
+        source: string;
+    };
+};
+type PostMessageOptions = {
+    srcWindow: Window;
+    targetWindow: Window;
+    message: any;
+};
+export declare const applicationScriptingObject: {
+    object: {
+        events: never[];
+        functions: string[];
+        objectId: string;
+        objectType: string;
+    };
+    type: string;
+};
+export declare const authScriptingObject: {
+    object: {
+        events: never[];
+        functions: string[];
+        objectId: string;
+        objectType: string;
+    };
+    type: string;
+};
+export declare const postMessage: ({ srcWindow, targetWindow, message, }: PostMessageOptions) => void;
+export declare const setupHost: (hostWindow: Window) => () => void;
+export {};

package/dist/types/lib/utils/micro-frontend/types.d.ts

@@ -1,17 +1,135 @@
 import { InitOptions } from '@elliemae/pui-micro-frontend-base';
+import { Events, ScriptingObjectTypes } from '@elliemae/pui-scripting-object';
+import { IFrameSandboxValues, WindowFeatures, OpenMode } from '@elliemae/ssf-host';
+/**
+ * Files specific to the mode of the micro-frontend application.
+ */
 type EnvConfig = {
+    /**
+     * Array of file paths specific to the environment (development or production).
+     * relative or absolute URLs
+     */
     files: Array<string>;
 };
+/**
+ * Modes in which a micro-frontend application can operate.
+ */
+export declare enum LaunchMode {
+    DEVELOPMENT = "development",
+    PRODUCTION = "production"
+}
+/**
+ * Library that manages the micro-frontend application.
+ */
+export declare enum MicroAppManager {
+    SSF = "ssf",
+    APPSDK = "appsdk"
+}
+/**
+ * additional options for ssf based micro-frontend applications.
+ */
+export type SSFAppOptions<SearchParams> = {
+    /**
+     * individual query parameters indicating guest application's url parameter string
+     */
+    searchParams?: SearchParams;
+    /**
+     * mode of opening the guest application, popup or embed
+     * @default OpenMode.Embed
+     */
+    openMode?: OpenMode;
+    /**
+     * flag to disable sandboxing for iframe
+     * @default false
+     */
+    disableSandbox?: boolean;
+    /**
+     * sandbox values for iframe
+     * @default [IFrameSandboxValues.AllowScripts, IFrameSandboxValues.AllowPopups, IFrameSandboxValues.AllowModals, IFrameSandboxValues.AllowForms, IFrameSandboxValues.AllowDownloads, IFrameSandboxValues.AllowSameOrigin ]
+     */
+    sandboxValues?: Array<IFrameSandboxValues>;
+    /**
+     * resize the iframe to fit the content inside
+     * @default true
+     */
+    fitToContent?: boolean;
+    /**
+     * css style for the microapp iframe
+     */
+    style?: string;
+    /**
+     * features for the popup window
+     * @default { width: 800, height: 600, top: 100, left: 100 }
+     */
+    popupWindowFeatures?: WindowFeatures;
+    /**
+     * permission policy for the guest iframe
+     * check https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe#allow for more details
+     * @example "microphone 'self' https://example.com; geolocation 'none'"
+     */
+    permissionPolicy?: string;
+};
+/**
+ * Configuration object for a micro-frontend application.
+ */
 export type MicroAppConfig = {
+    /**
+     * Unique identifier for the micro-frontend application.
+     */
     id: string;
+    /**
+     * Human-readable name for the micro-frontend application.
+     */
     name: string;
-    mode?: string;
+    /**
+     * Optional title for the micro-frontend application.
+     */
+    title?: string;
+    /**
+     * Mode in which the micro-frontend operates (e.g., 'development', 'production').
+     */
+    mode?: LaunchMode;
+    /**
+     * Base URL where the micro-frontend is hosted.
+     */
     hostUrl?: string;
+    /**
+     * Path to the manifest file for the micro-frontend.
+     */
     manifestPath?: string;
+    /**
+     * Route to the home page of the micro-frontend application.
+     */
     homeRoute: string;
+    /**
+     * If true, the micro-frontend is treated as a JavaScript module.
+     */
+    isJsModule?: boolean;
+    /**
+     * Library that manages the micro-frontend application (e.g., 'ssf', 'appsdk').
+     * @default 'appsdk'
+     */
+    microappManager?: MicroAppManager;
+    /**
+     * Array of file paths required by the micro-frontend application.
+     * relative or absolute URLs
+     */
     files?: Array<string>;
+    /**
+     * files specific to the development build.
+     */
     development?: EnvConfig;
+    /**
+     * files specific to the production build.
+     */
     production?: EnvConfig;
+    /**
+     * options for ssf based micro-frontend applications.
+     */
+    ssfAppOptions?: SSFAppOptions<Record<string, string | number | boolean>>;
+    /**
+     * The Document object associated with the micro-frontend application.
+     */
     documentEle: Document;
-} & InitOptions;
+} & InitOptions<Partial<ScriptingObjectTypes>, Events>;
 export {};

package/dist/types/lib/utils/redact-pii.d.ts

@@ -1 +1,25 @@
+/**
+ * Redacts personally identifiable information (PII) from data objects.
+ * Removes sensitive data like credit cards, SSNs, emails, passwords, addresses, etc.
+ * @template T - Type of the data object
+ * @param data - Object containing potential PII to redact
+ * @returns New object with PII fields replaced with '****'
+ * @example
+ * ```typescript
+ * const userData = {
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ *   ssn: '123-45-6789',
+ *   address: '123 Main St'
+ * };
+ *
+ * const sanitized = redactPii(userData);
+ * // {
+ * //   name: 'John Doe',
+ * //   email: '****',
+ * //   ssn: '****',
+ * //   address: '****'
+ * // }
+ * ```
+ */
 export declare const redactPii: <T>(data: T) => T;

package/dist/types/lib/utils/session.d.ts

@@ -9,20 +9,95 @@ type LISTENER = {
     (): void;
 };
 /**
- * reset the UI idle time counter
- * @param resetWarningModal - reset the warning modal
+ * Resets the user idle time counter.
+ * Call this when user performs an action to extend their session.
+ * @param resetWarningModal - If true, also resets the warning modal state (default: false)
+ * @example
+ * ```typescript
+ * // Reset idle time on user interaction
+ * document.addEventListener('click', () => {
+ *   resetUserIdleTime();
+ * });
+ *
+ * // Reset and close warning modal
+ * resetUserIdleTime(true);
+ * ```
  */
 export declare const resetUserIdleTime: ResetUserIdleTimeFn;
 /**
- * Extend the PSS session (Encompass session) by introspecting the token
- * also reset the UI idle time counter
+ * Extends the PSS session (Encompass session) by introspecting the token.
+ * Also resets the UI idle time counter.
+ * @throws Error if authorization token is not found
+ * @example
+ * ```typescript
+ * // Manually renew session
+ * await renewSession();
+ * ```
+ * @internal
  */
 export declare const renewSession: () => Promise<void>;
 export declare const stopSessionMonitoring: () => void;
 export declare const addEventListeners: () => void;
 export declare const initSessionMonitoring: () => void;
+/**
+ * Subscribes to session expiry warning events.
+ * The callback is invoked when the session is about to expire (based on warning interval).
+ * @param onSessionExpiryWarn - Callback function that receives the warning timestamp
+ * @returns Unsubscribe function to remove the listener
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeToSessionExpiryWarning((warningTime) => {
+ *   console.log('Session expiring at:', warningTime);
+ *   showWarningModal();
+ * });
+ *
+ * // Later, to unsubscribe
+ * unsubscribe();
+ * ```
+ */
 export declare const subscribeToSessionExpiryWarning: (onSessionExpiryWarn: WARNLISTENER) => () => void;
+/**
+ * Subscribes to session expiry events.
+ * The callback is invoked when the session has expired.
+ * @param onSessionExpiry - Callback function invoked on session expiry
+ * @returns Unsubscribe function to remove the listener
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeToSessionExpiry(() => {
+ *   console.log('Session expired');
+ *   window.location.href = '/login';
+ * });
+ * ```
+ */
 export declare const subscribeToSessionExpiry: (onSessionExpiry: LISTENER) => () => void;
+/**
+ * Subscribes to session reset events.
+ * The callback is invoked when the session idle time is reset.
+ * @param onResetListener - Callback function that receives reset modal flag
+ * @returns Unsubscribe function to remove the listener
+ * @example
+ * ```typescript
+ * subscribeToResetSession((shouldResetModal) => {
+ *   if (shouldResetModal) {
+ *     closeWarningModal();
+ *   }
+ * });
+ * ```
+ */
 export declare const subscribeToResetSession: (onResetListener: RESETLISTENER) => () => void;
+/**
+ * Starts tracking user activity for session management.
+ * Monitors user interactions on the specified element and invokes callback.
+ * @param element - DOM element to track activity on (typically document)
+ * @param cb - Callback function to invoke on user activity
+ * @returns Cleanup function to stop tracking
+ * @example
+ * ```typescript
+ * const cleanup = trackActivity(document, renewSession);
+ *
+ * // Later, stop tracking
+ * cleanup();
+ * ```
+ */
 export declare const trackActivity: (element: Document | null, cb: (...args: unknown[]) => unknown) => () => void;
 export {};

package/dist/types/lib/utils/testing/index.d.ts

@@ -1,4 +1,60 @@
 import { RenderOptions } from '@testing-library/react';
-declare const customRender: (ui: React.ReactElement, options?: Omit<RenderOptions, "queries">) => import("@testing-library/react").RenderResult<typeof import("@testing-library/dom/types/queries.js"), HTMLElement, HTMLElement>;
-export * from '@testing-library/react';
+declare const customRender: (ui: React.ReactElement, options?: Omit<RenderOptions, "queries">) => {
+    container: HTMLElement;
+    baseElement: HTMLElement;
+    debug: (baseElement?: Element | DocumentFragment | Array<Element | DocumentFragment>, maxLength?: number, options?: import("pretty-format").OptionsReceived) => void;
+    rerender: (ui: React.ReactNode) => void;
+    unmount: () => void;
+    asFragment: () => DocumentFragment;
+    getByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement;
+    getAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    queryByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement | null;
+    queryAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    findByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement;
+    getAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    queryByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement | null;
+    queryAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
+    findByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement;
+    getAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement[];
+    queryByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement | null;
+    queryAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement[];
+    findByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
+    getAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    queryByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
+    findByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    user: import("@testing-library/user-event").UserEvent;
+};
+export { screen, waitFor, waitForElementToBeRemoved, within, fireEvent, act, cleanup, renderHook, } from '@testing-library/react';
 export { customRender as render };

package/dist/types/lib/utils/testing/performance-mock.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared Performance API mock utilities for testing
+ */
+export declare class MockPerformanceObserver {
+    callback: PerformanceObserverCallback;
+    constructor(callback: PerformanceObserverCallback);
+    observe(): void;
+    disconnect(): void;
+}
+export declare const mockMarks: Map<string, PerformanceMark>;
+export declare const mockMeasures: PerformanceMeasure[];
+export declare const originalPerformance: Performance;
+/**
+ * Setup Performance API mock
+ * Call this in beforeEach or beforeAll
+ */
+export declare function setupPerformanceMock(): void;
+/**
+ * Clear performance mock data
+ * Call this in afterEach to reset state between tests
+ */
+export declare function clearPerformanceMock(): void;
+/**
+ * Restore original performance object
+ * Call this in afterEach or afterAll
+ */
+export declare function restorePerformance(): void;

package/dist/types/lib/utils/tests/logrocket.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/lib/utils/window.d.ts

@@ -1,27 +1,43 @@
 import { IMicroAppGuest, IMicroAppHost, BAEvent } from '@elliemae/pui-micro-frontend-base';
+import { ScriptingObjectTypes, Events } from '@elliemae/pui-scripting-object';
+import { ScriptingObjects, EventListeners } from '@elliemae/microfe-common';
+import { SSFGuest } from '@elliemae/ssf-guest';
 import { BreakPoint } from '@elliemae/pui-theme';
 import { Logger } from '@elliemae/pui-diagnostics';
+import { IMicroFEHost } from '@elliemae/pui-app-bridge';
+import type LogRocket from 'logrocket';
 import { LoginParams } from './auth/types';
-export type EMUI = {
-    [key: string]: IMicroAppGuest | IMicroAppGuest[];
+export type EMUI<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> = {
+    [key: string]: IMicroAppGuest<AppObjects, AppEvents> | IMicroAppGuest<AppObjects, AppEvents>[];
 } & {
     _BASE_PATH: string;
     _ASSET_PATH: string;
     version: string;
-    MicroAppHost?: IMicroAppHost;
+    MicroAppHost?: IMicroFEHost<AppObjects, AppEvents> | IMicroAppHost | SSFGuest<AppObjects, AppEvents>;
+    __host?: IMicroFEHost<AppObjects, AppEvents>;
     logger?: Logger;
+    logRocket?: typeof LogRocket;
+    logRocketConfig?: {
+        appId: string;
+        childDomains?: string[];
+        parentDomain?: string;
+        rootHostname?: string;
+    };
     appId: string;
     uuid: string;
     app?: IMicroAppGuest;
     loginParams: LoginParams;
 };
 declare global {
-    interface Window {
+    interface Window<AppObjects extends ScriptingObjects = Partial<ScriptingObjectTypes>, AppEvents extends EventListeners = Events> {
         gtmDataLayer: BAEvent[];
-        emui: EMUI;
+        emui: EMUI<AppObjects, AppEvents>;
+        __TEST__: {
+            [key: string]: unknown;
+        };
     }
 }
-export declare const getWindow: () => Window;
+export declare const getWindow: () => WindowProxy;
 export declare const getViewportSize: () => {
     width: number;
     height: number;

package/dist/types/lib/view/app-root/index.d.ts

@@ -12,5 +12,32 @@ type AppRootProps = {
     errorTemplate?: React.ComponentType;
     strictMode?: boolean;
 };
+/**
+ * Root component for SDK-based applications.
+ * Provides Redux store, routing, theming, error boundaries, and session management.
+ * @param props - AppRoot component props
+ * @param props.store - Redux store instance
+ * @param props.history - History instance for routing
+ * @param props.basename - Base path for routing (optional)
+ * @param props.theme - Theme object (defaults to Dimsum default theme)
+ * @param props.manageSession - Enable automatic session management (default: false)
+ * @param props.WaitMessage - Custom wait/loading message component
+ * @param props.errorTemplate - Custom error boundary template
+ * @param props.children - Application components
+ * @param props.strictMode - Enable React StrictMode (default: true)
+ * @example
+ * ```typescript
+ * import { AppRoot, configureStore, history } from '@elliemae/pui-app-sdk';
+ *
+ * const store = configureStore({}, history);
+ *
+ * ReactDOM.render(
+ *   <AppRoot store={store} history={history}>
+ *     <App />
+ *   </AppRoot>,
+ *   document.getElementById('root')
+ * );
+ * ```
+ */
 export declare const AppRoot: ({ store, history, basename, theme, manageSession, WaitMessage, errorTemplate, children, strictMode, }: AppRootProps) => import("react/jsx-runtime.js").JSX.Element;
 export {};

package/dist/types/lib/view/error-boundary/index.d.ts

@@ -3,6 +3,27 @@ interface ErrorBoundaryProps {
     children?: React.ReactNode;
     errorTemplate?: React.ComponentType;
 }
+/**
+ * React error boundary component that catches JavaScript errors in child components.
+ * Logs errors and displays a fallback UI instead of crashing the app.
+ * @example
+ * ```tsx
+ * import { ErrorBoundary } from '@elliemae/pui-app-sdk';
+ *
+ * function App() {
+ *   return (
+ *     <ErrorBoundary>
+ *       <MyApp />
+ *     </ErrorBoundary>
+ *   );
+ * }
+ *
+ * // With custom error template
+ * <ErrorBoundary errorTemplate={CustomErrorPage}>
+ *   <MyApp />
+ * </ErrorBoundary>
+ * ```
+ */
 export declare class ErrorBoundary extends React.Component<ErrorBoundaryProps> {
     constructor(props: ErrorBoundaryProps);
     componentDidCatch(error: Error, errorInfo: {

package/dist/types/lib/view/fields/combo-box/index.d.ts

@@ -5,4 +5,29 @@ export type ComboBoxProps<TFieldValues extends FieldValues = FieldValues, TName
     rules?: Omit<RegisterOptions<TFieldValues, TName>, 'valueAsNumber' | 'valueAsDate' | 'setValueAs'>;
     [x: string]: any;
 };
+/**
+ * Dropdown/select field component with React Hook Form integration.
+ * Wraps the Dimsum ComboBox component with form state management and validation.
+ * @template TFieldValues - Type of form field values
+ * @template TName - Field name type
+ * @param props - ComboBox component props
+ * @param props.name - Field name for form registration
+ * @param props.defaultValue - Default selected value
+ * @param props.rules - Validation rules
+ * @param props.options - Array of dropdown options
+ * @example
+ * ```tsx
+ * <Form onSubmit={handleSubmit}>
+ *   <ComboBox
+ *     name="country"
+ *     label="Country"
+ *     options={[
+ *       { label: 'USA', value: 'us' },
+ *       { label: 'Canada', value: 'ca' }
+ *     ]}
+ *     rules={{ required: 'Please select a country' }}
+ *   />
+ * </Form>
+ * ```
+ */
 export declare const ComboBox: ({ name, defaultValue, rules, ...rest }: ComboBoxProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/lib/view/fields/date-picker/index.d.ts

@@ -6,4 +6,25 @@ export type DatePickerProps<TFieldValues extends FieldValues = FieldValues, TNam
     rules?: Omit<RegisterOptions<TFieldValues, TName>, 'valueAsNumber' | 'valueAsDate' | 'setValueAs'>;
     [x: string]: any;
 };
+/**
+ * Date picker field component with React Hook Form integration.
+ * Wraps the Dimsum DatePicker component with form state management and validation.
+ * @template TFieldValues - Type of form field values
+ * @template TName - Field name type
+ * @param props - DatePicker component props
+ * @param props.name - Field name for form registration
+ * @param props.labelText - Label text for the date picker
+ * @param props.defaultValue - Default date value
+ * @param props.rules - Validation rules
+ * @example
+ * ```tsx
+ * <Form onSubmit={handleSubmit}>
+ *   <DatePicker
+ *     name="birthDate"
+ *     labelText="Birth Date"
+ *     rules={{ required: 'Birth date is required' }}
+ *   />
+ * </Form>
+ * ```
+ */
 export declare const DatePicker: ({ name, defaultValue, rules, ...rest }: DatePickerProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/lib/view/fields/date-time-picker/index.stories.d.ts

@@ -1,15 +1,40 @@
 import { Story, Meta } from '@storybook/react';
+import { DateTimePickerProps } from './index.js';
 declare const _default: Meta;
 export default _default;
-export declare const DateTimeInputs: Story<any>;
-export declare const FullDateTime: Story<any>;
-export declare const DateTimePickerExample: Story<any>;
-export declare const DateTimePickerControllerOnly: Story<any>;
-export declare const DateInputs: Story<any>;
-export declare const DatePicker: Story<any>;
-export declare const DatePickerControllerOnly: Story<any>;
-export declare const FullDate: Story<any>;
-export declare const FullTime: Story<any>;
-export declare const TimeInputs: Story<any>;
-export declare const TimePickerControllerOnly: Story<any>;
-export declare const TimePicker: Story<any>;
+export declare const DateTimeInputs: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const FullDateTime: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const DateTimePickerExample: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const DateTimePickerControllerOnly: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const DateInputs: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const DatePicker: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const DatePickerControllerOnly: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const FullDate: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const FullTime: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const TimeInputs: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const TimePickerControllerOnly: Story<DateTimePickerProps & {
+    labelText: string;
+}>;
+export declare const TimePicker: Story<DateTimePickerProps & {
+    labelText: string;
+}>;

package/dist/types/lib/view/fields/form-item-layout/index.d.ts

@@ -5,4 +5,4 @@ export type FormItemLayoutProps = {
     labelText?: string;
     [x: string]: any;
 };
-export declare const FormItemLayout: ({ name, ...rest }: FormItemLayoutProps) => import("react/jsx-runtime.js").JSX.Element;
+export declare const FormItemLayout: ({ name, ...rest }: FormItemLayoutProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/lib/view/fields/form-layout-block-item/index.d.ts

@@ -1,3 +1,3 @@
 import { DSFormLayoutBlockItemT } from '@elliemae/ds-form-layout-blocks';
 export type FormLayoutBlockItemProps = DSFormLayoutBlockItemT.Props;
-export declare const FormLayoutBlockItem: ({ inputID, label, ...rest }: FormLayoutBlockItemProps) => import("react/jsx-runtime.js").JSX.Element;
+export declare const FormLayoutBlockItem: ({ inputID, label, ...rest }: FormLayoutBlockItemProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/lib/view/fields/input-mask/index.d.ts

@@ -1,4 +1,4 @@
-import { MASK_TYPES, MASK_PIPES } from '@elliemae/ds-form';
+import { MASK_TYPES, MASK_PIPES } from '@elliemae/ds-legacy-form';
 import { RegisterOptions, FieldValues, FieldPath } from 'react-hook-form';
 export type InputMaskProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = {
     name: string;