udp-stencil-component-library 25.18.1 → 25.18.2-beta.10

package/dist/types/components/forms/udp-forms/udp-forms-renderer/udp-forms-renderer.d.ts

@@ -12,25 +12,18 @@ export declare class UdpFormsRenderer {
     closeSnackbar: Function;
     autoSaveDelay: number;
     history: any;
-    generic1: any;
-    generic2: any;
-    generic3: any;
-    initialValues: {
+    urlContext: Record<string, any>;
+    currentValues: {
         [name: string]: any;
     };
     submitSuccessful: boolean;
-    currentFormData: {
-        [name: string]: any;
-    };
     isLoading: boolean;
     isSaving: boolean;
     isSubmitted: boolean;
-    saveErrorMessage: string | null;
     dynamicSections: any[];
     isUpdatingSections: boolean;
     reRenderKey: number;
-    isFormDirty: boolean;
-    isUserUpdatedSections: boolean;
+    hasUnsavedChanges: boolean;
     sideSheetFollowUpFormsList: any[];
     followUpSideSheetTotalItems: number;
     isFollowUpFormsSideSheetOpen: boolean;
@@ -39,19 +32,17 @@ export declare class UdpFormsRenderer {
     private readonly componentMap;
     private tenantId;
     private debouncedManualSave;
-    private userId;
-    private userDisplayName;
+    private clientUserInfo;
     private udpForm;
     private udpFormSubmission;
     private formHandler;
     private formSubmissionHandler;
     private followUpParentSectionKey;
     private followUpParentQuestionKey;
+    private readonly publicFeatures;
     componentDidLoad(): void;
     private handleLaunchFollowUpFormSideSheet;
     componentWillLoad(): Promise<void>;
-    private initializeDynamicSections;
-    private findRepeatGroupKeys;
     /**
      * Duplicate a repeatable section
      */
@@ -60,19 +51,18 @@ export declare class UdpFormsRenderer {
      * Delete a repeatable section
      */
     private deleteRepeatableSection;
-    private applyUrlInitialValuesForAll;
     private handleSubmit;
     /**
      * Auto save (background save)
      */
     private performBackgroundSaveAndUpdateLocalSubmissionState;
-    private replaceUrlWithSubmissionId;
+    private performBackgroundSaveAndUpdateLocalSubmissionStateInternal;
+    private refreshSubmissionAndSyncState;
     /**
-     * Handle the user saving or deleting a comment
+     * Handle the user saving or deleting a comment (pre-submit, private forms only)
      */
-    private handleCommmentUpdate;
     /**
-     * Manual save function - debounced to 5 seconds
+     * Manual save function - debounced to 5 seconds (private forms only)
      */
     private handleManualSave;
     private handleQuestionCommentLiveCRUD;
@@ -87,6 +77,5 @@ export declare class UdpFormsRenderer {
     private renderFollowUpSideSheet;
     private isShowManualSaveIcon;
     private get isReadOnlyMode();
-    private get isShowCommentUI();
     render(): any;
 }

package/dist/types/components/forms/udp-forms/{utils → udp-forms-utils}/classes/UdpFormSubmission.d.ts

@@ -1,5 +1,5 @@
-import { UdpFormSubmissionStatus } from '../types';
 import { Guid, UdpTag } from "../../../../../global/types";
+import { UdpFormsSubmissionStatusEnum } from '../enums';
 export declare class UdpFormSubmission {
     id: Guid | null;
     formId: Guid | null;
@@ -8,7 +8,7 @@ export declare class UdpFormSubmission {
     unityUserId: Guid | null;
     clusterId: number | null;
     userDisplayName: string | null;
-    status: UdpFormSubmissionStatus | null;
+    status: UdpFormsSubmissionStatusEnum | null;
     businessObjectKey: string | null;
     udpTags: UdpTag[] | null;
     form: any | null;
@@ -18,15 +18,15 @@ export declare class UdpFormSubmission {
     generic1: string | null;
     generic2: string | null;
     generic3: string | null;
+    userEmail: string | null;
     constructor(initialData?: Partial<UdpFormSubmission>);
-    processSubmissionIntoFormDataWithoutValues(status: UdpFormSubmissionStatus): FormData;
+    processSubmissionIntoFormDataWithoutValues(status: UdpFormsSubmissionStatusEnum): FormData;
     processSubmissionIntoFormData(formInputValuesAndMetadata: Record<string, Record<string, {
         value: any;
         comments?: any[];
         files?: File[];
         metadata?: Record<string, any>;
-    }>>, status: UdpFormSubmissionStatus): FormData;
-    private resolveSubmissionStatus;
+    }>>, status: UdpFormsSubmissionStatusEnum): FormData;
     private buildBaseSubmissionData;
     private extractCleanedDataAndFiles;
     private extractValueAndFiles;

package/dist/types/components/forms/udp-forms/{utils → udp-forms-utils}/enums.d.ts

@@ -16,7 +16,8 @@ export declare enum UdpFormsFieldTypeEnum {
     Tally = 15,
     Number = 16,
     Paragraph = 17,
-    ImageUpload = 18
+    ImageUpload = 18,
+    FormMetadataDisplay = 19
 }
 export declare enum UdpFormsTypeEnum {
     Standard = "1",
@@ -24,5 +25,10 @@ export declare enum UdpFormsTypeEnum {
 }
 export declare enum UdpFormsPageIdEnum {
     FormBuilderPageId = "c77aa2c8-f8b8-41af-aa77-c8612fc918c1",
-    FormRendererPageId = "c696afbd-8d83-4f80-aaa1-9a3530a05a21"
+    FormRendererPageId = "2f451c02-a8ca-40a9-b96f-251c92f9b4e1"
+}
+export declare enum UdpFormsSubmissionStatusEnum {
+    InProgress = 1,
+    Submitted = 2,
+    Created = 3
 }

package/dist/types/components/forms/udp-forms/udp-forms-utils/form-handler/UdpFormHandler.d.ts

@@ -0,0 +1,10 @@
+import { Guid } from '../types';
+import { UdpForm } from '../classes/UdpForm';
+export declare class UdpFormHandler {
+    tenantId?: Guid;
+    isPublic: boolean;
+    constructor(tenantId?: Guid, isPublic?: boolean);
+    private buildDescribeUrl;
+    getFormByFormIdAndFormVersion(formId: Guid, formVersion: number): Promise<UdpForm>;
+}
+export declare const createUdpFormHandler: (isPublic?: boolean, tenantId?: Guid) => UdpFormHandler;

package/dist/types/components/forms/udp-forms/udp-forms-utils/form-submission-handler/FormSubmissionHandler.d.ts

@@ -0,0 +1,42 @@
+import { UdpFormSubmission } from '../classes/UdpFormSubmission';
+import { IFormSubmissionHandler } from './IFormSubmissionHandler';
+export type UdpFormSubmissionAccessMode = 'public' | 'private';
+/**
+ * Single handler for UdpFormSubmission operations.
+ *
+ * Behavior changes by access mode:
+ * - private: supports draft save and follow-ups; comments are saved via standard draft-save until submitted,
+ *            and via dedicated comment endpoints when submitted or viewed by a non-owner.
+ * - public : no draft save, no follow-ups; submit uses the `/UdpFormSubmission/public` endpoint;
+ *            comments use dedicated comment endpoints once a submission exists.
+ */
+export declare class FormSubmissionHandler implements IFormSubmissionHandler {
+    private readonly accessMode;
+    constructor(accessMode: UdpFormSubmissionAccessMode);
+    addComment(udpFormSubmission: UdpFormSubmission, comment: {
+        sectionKey: string;
+        questionKey: string;
+        value: string;
+        commentId?: string;
+    }): Promise<void>;
+    updateComment(udpFormSubmission: UdpFormSubmission, args: {
+        sectionKey: string;
+        questionKey: string;
+        commentId: string;
+        value: string;
+    }): Promise<void>;
+    deleteComment(udpFormSubmission: UdpFormSubmission, args: {
+        sectionKey: string;
+        questionKey: string;
+        commentId: string;
+    }): Promise<void>;
+    fetchAndPopulateUdpFormSubmissionObj(udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    createNewLinkedFollowUpFormSubmission(udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    saveCurrentFormSubmissionState(values: Record<string, any>, udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    finalizeFormSubmissionState(values: Record<string, any>, udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    private saveFormDataWithoutValues;
+    private getApiRequestInfo;
+    private saveSubmissionToDB;
+    private getFormSubmissionById;
+    private getFormSubmissionByIdAndUser;
+}

package/dist/types/components/forms/udp-forms/{utils → udp-forms-utils}/form-submission-handler/FormSubmissionHandlerFactory.d.ts

@@ -4,5 +4,5 @@ import { Guid } from '../types';
  * Factory for creating form submission handlers.
  */
 export declare class FormSubmissionHandlerFactory {
-    static create(isPublic: boolean, userId?: Guid | null, formId?: Guid, version?: number, tenantId?: Guid): IFormSubmissionHandler;
+    static create(isPublic: boolean, userId?: Guid | null): IFormSubmissionHandler;
 }

package/dist/types/components/forms/udp-forms/udp-forms-utils/form-submission-handler/IFormSubmissionHandler.d.ts

@@ -0,0 +1,54 @@
+import { UdpFormSubmission } from '../classes/UdpFormSubmission';
+/**
+ * Interface for form submission handlers (public/private).
+ */
+export interface IFormSubmissionHandler {
+    /**
+     * Given a partially-populated `UdpFormSubmission` (must include `id`), fetch the latest submission from the server
+     * and return a hydrated `UdpFormSubmission`.
+     */
+    fetchAndPopulateUdpFormSubmissionObj(udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    /**
+     * Submit/finalize the form.
+     * - private: POST/PUT to `/UdpFormSubmission/private`
+     * - public : POST to `/UdpFormSubmission/public`
+     * Returns the saved submission (callers should use the return value or rely on handler mutating the passed instance).
+     */
+    finalizeFormSubmissionState(values: Record<string, any>, udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    /**
+     * Save draft/in-progress state.
+     * - private: POST/PUT to `/UdpFormSubmission/private`
+     * - public : no-op (public draft saves are disabled)
+     * Returns the saved submission (callers should use the return value or rely on handler mutating the passed instance).
+     */
+    saveCurrentFormSubmissionState(values: Record<string, any>, udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    /**
+     * Create a new follow-up submission and link it to a parent submission.
+     * private only.
+     */
+    createNewLinkedFollowUpFormSubmission(udpFormSubmission: UdpFormSubmission): Promise<UdpFormSubmission>;
+    /**
+     * Append a single question comment to an existing submission.
+     * Intended for submitted forms to avoid PUT-ing the entire submission.
+     * Used by both public and private forms, but only for adding new comments. Does not mutate any form data values.
+     */
+    addComment(udpFormSubmission: UdpFormSubmission, comment: {
+        sectionKey: string;
+        questionKey: string;
+        value: string;
+        commentId?: string;
+    }): Promise<void>;
+    /** Update a previously-saved comment's value. */
+    updateComment(udpFormSubmission: UdpFormSubmission, args: {
+        sectionKey: string;
+        questionKey: string;
+        commentId: string;
+        value: string;
+    }): Promise<void>;
+    /** Soft-delete a previously-saved comment. */
+    deleteComment(udpFormSubmission: UdpFormSubmission, args: {
+        sectionKey: string;
+        questionKey: string;
+        commentId: string;
+    }): Promise<void>;
+}

package/dist/types/components/forms/udp-forms/{utils → udp-forms-utils}/types.d.ts

@@ -50,7 +50,6 @@ export interface FontOverrides {
     variant?: TypographyVariant;
     fontFamily?: string;
 }
-export type UdpFormSubmissionStatus = 'in-progress' | 'submitted' | 1 | 2;
 export interface UdpFormQuestionComment {
     timestamp: Date;
     value: string;
@@ -76,3 +75,19 @@ export interface UdpFormMetadata {
     styleOverrides: object;
     id: Guid;
 }
+export type SubmissionResponseData = Record<string, Record<string, {
+    value: any;
+    comments?: any[];
+    metadata?: Record<string, any>;
+}>>;
+export type DynamicSection = {
+    name: string;
+    isOriginalSection: boolean;
+    sectionPositionSuffix?: number;
+    formQuestions: Array<{
+        name: string;
+        fieldTypeId?: number;
+        fieldProperties?: any;
+        questionIdentifierKey?: string;
+    }>;
+};

package/dist/types/components/forms/udp-forms/{utils → udp-forms-utils}/utils.d.ts

@@ -3,7 +3,7 @@ import { UdpForm } from "../../../../components";
  * Translate and format UTC timestamp to local time.
  */
 export declare const dateFormatter: (dateString: string, formatStyle?: "long" | "short") => string;
-export declare const buildEmptyInitialValues: (masterForm: UdpForm) => {};
+export declare const buildEmptyCurrentValues: (masterForm: UdpForm) => {};
 export declare const overrideFont: (element: HTMLElement, cssVariable: any) => void;
 export declare const fontOverrideMapping: {
     Arial: string;

package/dist/types/components/forms/udp-forms/udp-question/udp-question-comment/udp-question-comments.d.ts

@@ -1,9 +1,9 @@
 import { EventEmitter } from '../../../../../stencil-public-runtime';
-import { UdpFormQuestion, Guid } from '../../utils/types';
+import { UdpFormQuestion, Guid } from '../../udp-forms-utils/types';
 export declare class UdpQuestionComments {
     question: UdpFormQuestion;
     commentFieldProps: object;
-    initialValues: {
+    currentValues: {
         [name: string]: any;
     };
     userId: Guid | null;

package/dist/types/components/forms/udp-forms/udp-question/udp-question.d.ts

@@ -1,6 +1,7 @@
 import { EventEmitter } from '../../../../stencil-public-runtime';
-import { UdpFormQuestion, Guid } from '../utils/types';
-import { FontOverrides } from '../utils/types';
+import { UdpFormQuestion } from '../udp-forms-utils/types';
+import { FontOverrides } from '../udp-forms-utils/types';
+import { UdpFormSubmission } from '../udp-forms-utils/classes/UdpFormSubmission';
 export declare class UdpQuestion {
     question: UdpFormQuestion;
     questionNumber: number;
@@ -12,11 +13,15 @@ export declare class UdpQuestion {
         questionText: FontOverrides;
         paragraphText: FontOverrides;
     };
-    initialValues: {
+    currentValues: {
         [name: string]: any;
     };
-    userId: Guid | null;
-    isCommentAllowed: boolean;
+    clientUserInfo: {
+        id: string | null;
+        displayName: string | null;
+        email: string | null;
+    };
+    udpFormSubmission: UdpFormSubmission;
     launchFollowUpFormSideSheet: EventEmitter<any>;
     private _fieldComponent;
     private tallyData;

package/dist/types/components/grid/new-grid/gridFunctions/bulkActions.d.ts

@@ -8,7 +8,8 @@ export declare class BulkActions implements GridFunction {
     private fetchedData;
     private refresh;
     private gridId;
-    private executeActionCallback;
+    private actionProviderCallback;
+    private localFunctions;
     private isMenuOpen;
     private menuAnchorEl?;
     init(api: GridApi, refresh: () => void, params?: any): void;
@@ -16,7 +17,8 @@ export declare class BulkActions implements GridFunction {
     onRowSelectionChanged: () => void;
     private fetchBulkActions;
     setBulkActions: (data: any) => void;
-    executeBulkAction: (actionId: any) => void;
+    executeLocalFunction: (functionName: string) => void;
+    executeActionProviderAction: (actionId: any) => void;
     toggleMenu: () => void;
     closeMenu: () => void;
     render(): any;

package/dist/types/components/grid/new-grid/interfaces/grid.d.ts

@@ -19,6 +19,7 @@ export interface GridApiMethods {
     getSelectedNodes: () => IRowNode<any>[];
     getSearchObject: () => Search;
     getEntityName: () => string;
+    getRowCount: () => number;
     getFilterModel: () => FilterModel;
     setFilterModel: (model: FilterModel) => void;
     onFilterChanged: () => void;

package/dist/types/components/inputs/form metadata display/form-metadata-display.d.ts

@@ -0,0 +1,62 @@
+/**
+ * A small display-only component for showing read-only form metadata.
+ *
+ * Intended usage:
+ * - Rendered near the top or bottom of a form submission view
+ * - Pure presentational output based on props (no internal state, no events)
+ *
+ * Layout:
+ * - Uses a simple "label + value" row pattern for consistent alignment
+ * - Hides rows when the corresponding value is missing or the display flag is false
+ *
+ * @example
+ * ```tsx
+ * <form-metadata-display
+ *   userDisplayName="Ada Lovelace"
+ *   userEmail="ada@example.com"
+ *   submittedOn={new Date()}
+ * />
+ * ```
+ */
+export declare class FormMetadataDisplay {
+    /**
+     * Full name (or display name) of the form owner/submitter.
+     * Row is only rendered when `displayOwnerFullName` is true and this value is non-empty.
+     */
+    userDisplayName: string;
+    /**
+     * Email of the form owner/submitter.
+     * Row is only rendered when `displayOwnerEmail` is true and this value is non-empty.
+     */
+    userEmail: string;
+    /**
+     * Submission timestamp.
+     * Row is only rendered when `displaySubmissionDate` is true and this value is non-null.
+     */
+    submittedOn: string | null;
+    /**
+     * Toggles rendering of the "Name" row.
+     * Defaults to true.
+     */
+    displayOwnerFullName: boolean;
+    /**
+     * Toggles rendering of the "Email" row.
+     * Defaults to true.
+     */
+    displayOwnerEmail: boolean;
+    /**
+     * Toggles rendering of the "Submitted on" row.
+     * Defaults to true.
+     */
+    displaySubmissionDate: boolean;
+    /**
+     * Renders a single metadata row using a standard label/value layout.
+     * @internal
+     */
+    renderRow(label: string, value: string): any;
+    /**
+     * Renders the metadata container. Rows are conditionally included based on flags + data presence.
+     * @internal
+     */
+    render(): any;
+}