@genesislcap/foundation-forms 14.496.2-alpha-da9ccbd.0 → 14.497.0

package/dist/foundation-forms.d.ts

@@ -9,6 +9,7 @@ import { FASTElement } from '@microsoft/fast-element';
 import { FilterMode } from '@genesislcap/foundation-ui';
 import { FoundationElement } from '@microsoft/fast-foundation';
 import { FoundationLayoutContainer } from '@genesislcap/foundation-utils';
+import { JsonFormsCore } from '@jsonforms/core';
 import { JsonFormsState } from '@jsonforms/core';
 import type { JsonSchema } from '@jsonforms/core';
 import { JSONSchema7 } from 'json-schema';
@@ -179,6 +180,32 @@ export declare type ArrayRendererOptions = {
     showRowStatusIndicator?: boolean;
 };
 
+/**
+ * Builds the review panel's fields grouped into sections by their nearest `Group` layout.
+ * Sections are formed from consecutive runs of the same group title as fields are
+ * encountered in the UI schema — not a global title lookup — so two fields that happen to
+ * share a title (including `null`, for ungrouped fields) don't get merged into one section
+ * unless they're actually adjacent. Otherwise an ungrouped field appearing after a Group
+ * would jump back up next to earlier ungrouped fields instead of staying where it sits in
+ * the form, and two distinct Groups with the same label would collapse into one. Falls back
+ * to a flat, single ungrouped section when no UI schema is available.
+ *
+ * Async because connected-select fields backed by `options.allOptionsResourceName` (rather
+ * than a static `options.data`) resolve their display label with a criteria-filtered fetch
+ * — see `resolveResourceOptionLabel`. The UI schema is walked synchronously to collect one
+ * value-resolution promise per field (preserving encounter order), then all promises settle
+ * in parallel via `Promise.all` before fields are added to their sections — so a slow fetch
+ * for one field can't reorder fields that resolved faster.
+ *
+ * This is the single walker of the UI schema for review purposes — `Form` calls it directly
+ * to populate `Review.sections`. Don't reimplement this traversal elsewhere; the two
+ * previously did drift (a since-removed `collectReviewFields` resolved labels via
+ * `resolveOptionLabel` / `resolveEnumLabel` only, silently skipping `resolveResourceOptionLabel`
+ * and showing raw ids for connected-select fields).
+ * @internal
+ */
+export declare function buildReviewSections(data: Record<string, any>, uiSchema: any, schema: any): Promise<ReviewSection[]>;
+
 /**
  * Tracks the submission status and result for a single row in bulk insert mode.
  * @public
@@ -596,6 +623,14 @@ export declare function extractFieldsFromUiSchema(uiSchema: UiSchema): Array<{
     isHidden: boolean;
 }>;
 
+/**
+ * Filters review sections down to fields whose label or value contains `query`
+ * (case-insensitive). Sections left with no matching fields are dropped entirely.
+ * Returns `sections` unchanged when `query` is blank.
+ * @internal
+ */
+export declare function filterReviewSections(sections: ReviewSection[], query: string): ReviewSection[];
+
 /**
  * Foundation filters component for automatically generated filters based on json schema
  * obtained from the api, supplied initial data or supplied JSON schema.
@@ -738,7 +773,6 @@ declare const Filters_base: (new (...args: any[]) => {
     #_hasFirstLoaded: boolean;
     #_cleanupTimeout: NodeJS.Timeout;
     #_shouldForceLifecycle: boolean;
-    #_blockedDisconnectSurvivedGracePeriod: boolean;
     cloneNode(deep?: boolean): Node;
     deepClone(): Node;
     get shouldRunDisconnect(): boolean;
@@ -1197,6 +1231,16 @@ export declare class Form extends Form_base {
      * @internal
      */
     serverFieldErrors: ErrorObject[];
+    /**
+     * Reference to the json-forms child element — used to read live validation
+     * errors at submit time so review mode never activates when the form is invalid.
+     * @internal
+     */
+    jsonFormsEl: {
+        jsonforms?: {
+            core?: JsonFormsCore;
+        };
+    };
     /**
      * Stores the approval message entered by the user.
      * @internal
@@ -1320,6 +1364,24 @@ export declare class Form extends Form_base {
      * @public
      */
     bulkInsert: boolean;
+    /**
+     * Text to appear on submit button
+     * @default Submit
+     * @public
+     */
+    submitButtonText: string;
+    /**
+     * Text to appear on submit button in bulk insert mode
+     * @default Submit AllS
+     * @public
+     */
+    bulkSubmitButtonText: string;
+    /**
+     * Text to appear on reset button
+     * @default Submit
+     * @public
+     */
+    resetButtonText: string;
     /**
      * Minimum number of items required in bulk insert mode.
      * @public
@@ -1340,16 +1402,80 @@ export declare class Form extends Form_base {
      * @internal
      */
     private userProvidedUiSchema;
+    /**
+     * When enabled, clicking submit with no validation errors shows a read-only preview
+     * of the form data before the final submission.
+     * @public
+     */
+    showSubmitReview: boolean;
+    /**
+     * Text to appear on reset button
+     * @public
+     */
+    reviewButtonText: string;
+    /**
+     * Heading shown at the top of the review panel.
+     * @public
+     */
+    reviewHeading: string;
+    /**
+     * Name of a top-level data field whose value is shown as an identifier next to the
+     * review heading (e.g. a record's primary key). No identifier is shown when unset.
+     * @public
+     */
+    reviewIdField: string;
     /**
      * Tracks the submission status for each row in bulk insert mode.
      * Key is the row index, value is the status object.
      * @public
      */
     rowSubmitStatuses: Map<number, BulkRowStatus>;
+    /**
+     * Whether the form is currently showing the submit-review preview panel.
+     * @internal
+     */
+    reviewMode: boolean;
+    /**
+     * Field label/value pairs rendered in the review panel, grouped into sections.
+     * @internal
+     */
+    reviewSections: ReviewSection[];
+    /**
+     * Value of `reviewIdField` resolved from the current form data, if set.
+     * @internal
+     */
+    get reviewRecordId(): string | undefined;
     /**
      * @internal
      */
     _submit(): Promise<void>;
+    /**
+     * Called from the review panel to go back to the form.
+     * @internal
+     */
+    backFromReview(): void;
+    /**
+     * Called from the review panel submit button to perform the actual submission.
+     * Intentionally skips `confirmationMessage` — that gate already ran once in `_submit()`
+     * before review mode was entered, and re-confirming here would ask the user twice.
+     * @internal
+     */
+    _submitFromReview(): Promise<void>;
+    /**
+     * Whether the form currently has validation errors. Reads live errors directly from the
+     * json-forms element when it's mounted, so we always use the current validation state
+     * (this.errors can lag in edge cases such as required fields with empty-string values not
+     * yet reported via data-change). Falls back to this.errors when json-forms isn't mounted
+     * (e.g. while the read-only review panel is showing), which is safe since no interactive
+     * editing happens during review.
+     * @internal
+     */
+    private hasValidationErrors;
+    /**
+     * Performs the actual API submission after review (or directly when review is disabled).
+     * @internal
+     */
+    private _performSubmit;
     /**
      * Handles bulk insert submission by iterating through items and submitting each separately.
      * Updates rowSubmitStatuses to provide row-level feedback.
@@ -1477,7 +1603,6 @@ declare const Form_base: (new (...args: any[]) => {
     #_hasFirstLoaded: boolean;
     #_cleanupTimeout: NodeJS.Timeout;
     #_shouldForceLifecycle: boolean;
-    #_blockedDisconnectSurvivedGracePeriod: boolean;
     cloneNode(deep?: boolean): Node;
     deepClone(): Node;
     get shouldRunDisconnect(): boolean;
@@ -1839,6 +1964,14 @@ declare const Form_base: (new (...args: any[]) => {
     focus(options?: FocusOptions): void;
 }) & typeof FoundationElement;
 
+/**
+ * Converts a raw field value to a display string for the review panel.
+ * Arrays of primitives are comma-joined; arrays of objects and plain objects
+ * are rendered as readable `key: value` lines.
+ * @internal
+ */
+export declare function formatValueForReview(value: any): string;
+
 /**
  * Detail payload for the `data-change` event fired by {@link Form} and `JSONForms` whenever
  * the bound form data changes.
@@ -1864,6 +1997,12 @@ export declare type FormDataChangeEventDetail = {
     path?: string;
 };
 
+/** @internal */
+export declare const foundationFormReviewStyles: ElementStyles;
+
+/** @internal */
+export declare const foundationFormReviewTemplate: ViewTemplate<Review, any>;
+
 /** @internal */
 export declare const foundationFormStyles: ElementStyles;
 
@@ -1941,9 +2080,19 @@ export declare enum GenesisType {
  */
 export declare const getAnyOfErrorMessage: (errors: Array<any> | undefined, schema: any, controlPath: string | undefined, uiCustomMsg?: string) => string;
 
+/**
+ * Navigates a `/properties/`-separated path in data to support nested object scopes
+ * such as `ADDRESS/properties/STREET` produced by Group layout UI schemas.
+ * @internal
+ */
+export declare function getDataValueAtPath(data: any, fieldName: string): any;
+
 /** @internal */
 export declare const getPrefixedForm: (prefix: any) => ViewTemplate<Form, any>;
 
+/** @internal */
+export declare const getPrefixedReview: (prefix: any) => ViewTemplate<Review, any>;
+
 /**
  * Fixed height (CSS value) for vertical categorization when `layout` is `{ type: 'vertical'; height?: string }`.
  * @public
@@ -2300,6 +2449,79 @@ export declare type RendererEntry = {
  */
 export declare const renderers: any[];
 
+/**
+ * For plain enum combobox fields (no options.data), applies the same `capitalCase`
+ * transform the renderer uses — e.g. `SEMI_ANNUAL` → `Semi Annual`.
+ * Navigates the JSON schema via the fieldName path to confirm the field is an enum
+ * before transforming. Returns `null` for non-enum fields.
+ * @internal
+ */
+export declare function resolveEnumLabel(raw: any, fieldName: string, schema: any): string | null;
+
+/**
+ * Looks up the display label for a raw value from `options.data` (used by segmented,
+ * radio group, connected-select, and enum-with-explicit-data renderers). Honors
+ * `options.valueField`/`options.labelField` when set, defaulting to `value`/`label`.
+ * Returns `null` when no match found.
+ * @internal
+ */
+export declare function resolveOptionLabel(raw: any, options: any): string | null;
+
+/**
+ * Resolves the display label for a connected-select field backed by
+ * `options.allOptionsResourceName` (a Data Server/Request Server resource) rather than a
+ * static `options.data` array — e.g. `ConnectedSelectControlRenderer` in async/remote mode.
+ * Fetches a single row via a criteria-filtered snapshot matching `valueField === raw`,
+ * then reads `labelField` off the returned row. Returns `null` when there's no resource
+ * to query, the resource can't be reached, or no row matches.
+ * @internal
+ */
+export declare function resolveResourceOptionLabel(raw: any, options: any): Promise<string | null>;
+
+/**
+ * Read-only preview panel shown by `<foundation-form>` when `show-submit-review` is enabled.
+ * Renders the reviewed data grouped into sections with a header and a filter field.
+ * @public
+ */
+export declare class Review extends FASTElement {
+    prefix: string;
+    /**
+     * Title shown in the review header.
+     * @public
+     */
+    heading: string;
+    /**
+     * Optional identifier shown next to the heading, e.g. a record's primary key.
+     * @public
+     */
+    recordId: string;
+    /**
+     * Sections of label/value pairs to render, grouped by their nearest UI schema `Group`.
+     * @public
+     */
+    sections: ReviewSection[];
+    /**
+     * Free-text query filtering fields by label or value. Sections with no matching
+     * fields are hidden.
+     * @internal
+     */
+    filterText: string;
+    /** @internal */
+    get filteredSections(): ReviewSection[];
+}
+
+/** @public */
+export declare type ReviewField = {
+    label: string;
+    value: string;
+};
+
+/** @public */
+export declare type ReviewSection = {
+    title: string | null;
+    fields: ReviewField[];
+};
+
 /**
  * Detail payload for the `row-status-changed` event fired by {@link Form} whenever the
  * submission status of one or all bulk insert rows changes.

package/dist/react.cjs

@@ -17,6 +17,7 @@ const { StepperWrapper: StepperWrapperWC } = require('./esm/jsonforms/renderers/
 const { VerticalCategorizationWrapper: VerticalCategorizationWrapperWC } = require('./esm/jsonforms/renderers/VerticalCategorizationWrapperRenderer.js');
 const { DispatchRenderer: DispatchRendererWC } = require('./esm/jsonforms/renderers/dispatch-renderer.js');
 const { FoundationReactSlot: FoundationReactSlotWC } = require('./esm/jsonforms/renderers/foundation-react-slot.js');
+const { Review: ReviewWC } = require('./esm/review.js');
 
 function _mergeRefs(...refs) {
   return (value) => {
@@ -104,6 +105,11 @@ const Form = React.forwardRef(function Form(props, ref) {
   return React.createElement(customElements.getName(FormWC) ?? 'foundation-form', { ...rest, ref: _mergeRefs(_innerRef, ref) }, children);
 });
 
+const Review = React.forwardRef(function Review(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(ReviewWC) ?? 'foundation-form-review', { ...rest, ref }, children);
+});
+
 const Filters = React.forwardRef(function Filters(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(FiltersWC) ?? 'foundation-filters', { ...rest, ref }, children);
@@ -168,6 +174,7 @@ const FoundationReactSlot = React.forwardRef(function FoundationReactSlot(props,
 
 module.exports = {
   Form,
+  Review,
   Filters,
   JSONForms,
   ArrayListWrapper,

package/dist/react.mjs

@@ -15,6 +15,7 @@ import { StepperWrapper as StepperWrapperWC } from './esm/jsonforms/renderers/St
 import { VerticalCategorizationWrapper as VerticalCategorizationWrapperWC } from './esm/jsonforms/renderers/VerticalCategorizationWrapperRenderer.js';
 import { DispatchRenderer as DispatchRendererWC } from './esm/jsonforms/renderers/dispatch-renderer.js';
 import { FoundationReactSlot as FoundationReactSlotWC } from './esm/jsonforms/renderers/foundation-react-slot.js';
+import { Review as ReviewWC } from './esm/review.js';
 
 function _mergeRefs(...refs) {
   return (value) => {
@@ -102,6 +103,11 @@ export const Form = React.forwardRef(function Form(props, ref) {
   return React.createElement(customElements.getName(FormWC) ?? 'foundation-form', { ...rest, ref: _mergeRefs(_innerRef, ref) }, children);
 });
 
+export const Review = React.forwardRef(function Review(props, ref) {
+  const { children, ...rest } = props;
+  return React.createElement(customElements.getName(ReviewWC) ?? 'foundation-form-review', { ...rest, ref }, children);
+});
+
 export const Filters = React.forwardRef(function Filters(props, ref) {
   const { children, ...rest } = props;
   return React.createElement(customElements.getName(FiltersWC) ?? 'foundation-filters', { ...rest, ref }, children);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-forms",
   "description": "Genesis Foundation Forms",
-  "version": "14.496.2-alpha-da9ccbd.0",
+  "version": "14.497.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -59,13 +59,13 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/genx": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/rollup-builder": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/ts-builder": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/uvu-playwright-builder": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/vite-builder": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/webpack-builder": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/foundation-testing": "14.497.0",
+    "@genesislcap/genx": "14.497.0",
+    "@genesislcap/rollup-builder": "14.497.0",
+    "@genesislcap/ts-builder": "14.497.0",
+    "@genesislcap/uvu-playwright-builder": "14.497.0",
+    "@genesislcap/vite-builder": "14.497.0",
+    "@genesislcap/webpack-builder": "14.497.0",
     "@types/json-schema": "^7.0.11",
     "@types/papaparse": "^5.3.14"
   },
@@ -82,12 +82,12 @@
     }
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/foundation-criteria": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/foundation-logger": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/foundation-notifications": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/foundation-ui": "14.496.2-alpha-da9ccbd.0",
-    "@genesislcap/foundation-utils": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/foundation-comms": "14.497.0",
+    "@genesislcap/foundation-criteria": "14.497.0",
+    "@genesislcap/foundation-logger": "14.497.0",
+    "@genesislcap/foundation-notifications": "14.497.0",
+    "@genesislcap/foundation-ui": "14.497.0",
+    "@genesislcap/foundation-utils": "14.497.0",
     "@json-schema-tools/dereferencer": "^1.6.1",
     "@jsonforms/core": "^3.2.1",
     "@microsoft/fast-components": "2.30.6",
@@ -109,5 +109,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "daac29f621ee844cc6e269c0b8bd52c56bff8cf0"
+  "gitHead": "8859a3cd83bd40fc5e5bbff9be5ebe02380fb6ec"
 }