@genesislcap/foundation-forms 14.487.0 → 14.488.1-FUI-2571.1

package/dist/esm/form.template.js

@@ -6,11 +6,12 @@ import { CategorizationWrapper } from './jsonforms/renderers/CategorizationWrapp
 import { DispatchRenderer } from './jsonforms/renderers/dispatch-renderer';
 import { StepperWrapper } from './jsonforms/renderers/StepperWrapperRenderer';
 import { VerticalCategorizationWrapper } from './jsonforms/renderers/VerticalCategorizationWrapperRenderer';
-avoidTreeShaking(JSONForms, ArrayListWrapper, CategorizationWrapper, VerticalCategorizationWrapper, DispatchRenderer, StepperWrapper);
+import { Review } from './review';
+avoidTreeShaking(JSONForms, ArrayListWrapper, CategorizationWrapper, VerticalCategorizationWrapper, DispatchRenderer, StepperWrapper, Review);
 /** @internal */
 export const getPrefixedForm = (prefix) => html `
   <template>
-    ${when((x) => x.bulkInsert, html `
+    ${when((x) => !x.reviewMode && x.bulkInsert, html `
         <div class="csv-upload-section" part="csv-upload">
           <input
             type="file"
@@ -39,43 +40,76 @@ export const getPrefixedForm = (prefix) => html `
           </${prefix}-button>
         </div>
       `)}
-    <json-forms
-      @submit-button-clicked=${(x) => x._submit()}
-      @submit-part=${(x, c) => x.submitPart(c.event)}
-      @submit-single-row=${(x, c) => x.submitSingleRow(c.event.detail.index)}
-      @reset-form=${(x) => x.reset(false)}
-      ?readonly=${(x) => x.readonly}
-      :submitted=${(x) => x.submitted}
-      :renderers=${(x) => x.mergedRenderers}
-      :uischema=${(x) => x.uischema}
-      :schema=${(x) => x.jsonSchema}
-      :data=${(x) => x.data}
-      :serverFieldErrors=${(x) => x.serverFieldErrors}
-      :prefix=${(x) => x.prefix}
-      :rowSubmitStatuses=${(x) => x.rowSubmitStatuses}
-      :bulkInsert=${(x) => x.bulkInsert}
-      @data-change=${(x, c) => x.onChange(c.event)}
-    ></json-forms>
-    ${when((x) => x.isSubmitHidden || x.isResetVisible, html `
+    ${when((x) => !x.reviewMode, html `
+        <json-forms
+          ${ref('jsonFormsEl')}
+          @submit-button-clicked=${(x) => x._submit()}
+          @submit-part=${(x, c) => x.submitPart(c.event)}
+          @submit-single-row=${(x, c) => x.submitSingleRow(c.event.detail.index)}
+          @reset-form=${(x) => x.reset(false)}
+          ?readonly=${(x) => x.readonly}
+          :submitted=${(x) => x.submitted}
+          :renderers=${(x) => x.mergedRenderers}
+          :uischema=${(x) => x.uischema}
+          :schema=${(x) => x.jsonSchema}
+          :data=${(x) => x.data}
+          :serverFieldErrors=${(x) => x.serverFieldErrors}
+          :prefix=${(x) => x.prefix}
+          :rowSubmitStatuses=${(x) => x.rowSubmitStatuses}
+          :bulkInsert=${(x) => x.bulkInsert}
+          @data-change=${(x, c) => x.onChange(c.event)}
+        ></json-forms>
+      `)}
+    ${when((x) => x.reviewMode, html `
+        <foundation-form-review
+          part="review-panel"
+          design-system-prefix=${(x) => x.prefix}
+          heading=${(x) => x.reviewHeading}
+          :recordId=${(x) => x.reviewRecordId}
+          :sections=${(x) => x.reviewSections}
+        ></foundation-form-review>
+      `)}
+    ${when((x) => x.reviewMode || x.isSubmitHidden || x.isResetVisible, html `
         <slot name="userActions" part="userActions" class="actions">
-          ${when((x) => x.isResetVisible, html `
+          ${when((x) => !x.reviewMode && x.isResetVisible, html `
               <${prefix}-button
                 @click="${(x) => x.handleResetClicked()}"
                 class="reset-button"
                 appearance="neutral"
                 data-test-id="reset-button"
               >
-                Reset
+                ${(x) => x.resetButtonText}
+              </${prefix}-button>
+            `)}
+          ${when((x) => x.reviewMode, html `
+              <${prefix}-button
+                @click="${(x) => x.backFromReview()}"
+                class="reset-button"
+                appearance="neutral"
+                data-test-id="review-back-button"
+              >
+                Back
               </${prefix}-button>
             `)}
-          ${when((x) => x.isSubmitHidden, html `
+          ${when((x) => !x.reviewMode && x.isSubmitHidden, html `
               <${prefix}-button
                 @click="${(x) => x._submit()}"
                 ?disable=${(x) => !x.submitting}
                 class="submit-button"
                 appearance="accent"
               >
-                ${(x) => (x.bulkInsert ? 'Submit All' : 'Submit')}
+                ${(x) => (x.bulkInsert ? x.bulkSubmitButtonText : x.submitButtonText)}
+              </${prefix}-button>
+            `)}
+          ${when((x) => x.reviewMode, html `
+              <${prefix}-button
+                @click="${(x) => x._submitFromReview()}"
+                ?disabled=${(x) => x.submitting}
+                class="submit-button"
+                appearance="accent"
+                data-test-id="review-submit-button"
+              >
+                ${(x) => (x.showSubmitReview ? x.reviewButtonText : x.submitButtonText)}
               </${prefix}-button>
             `)}
         </slot>

package/dist/esm/index.js

@@ -2,6 +2,9 @@ export * from './filters';
 export * from './form';
 export * from './form.styles';
 export * from './form.template';
+export * from './review';
+export * from './review.styles';
+export * from './review.template';
 export { MulticolumnDropdownControlRendererEntry, MulticolumnDropdownControlRendererTemplate, } from './jsonforms/renderers/MulticolumnDropdownControlRenderer';
 export { LayoutVerticalCategorizationRendererEntry } from './jsonforms/renderers/LayoutVerticalCategorizationRenderer';
 export { controlWrapperTemplate, controlWrapperStyles, 

package/dist/esm/jsonforms/renderers/CategorizationWrapperRenderer.js

@@ -1,6 +1,7 @@
 import { __decorate } from "tslib";
 import { html, css, observable, customElement, FASTElement, repeat, when, } from '@microsoft/fast-element';
 import { classNames } from '@microsoft/fast-web-utilities';
+import { extractErrorScopes, uiSchemaHasAnyError } from '../../utils/schema-utils';
 /**
  * Resolves the `activeCategory` option (the zero-based index of the category
  * tab that should open on first render) to a valid tab index. Out-of-bounds or
@@ -160,48 +161,3 @@ CategorizationWrapper = __decorate([
     })
 ], CategorizationWrapper);
 export { CategorizationWrapper };
-function uiSchemaHasAnyError(uiSchema, errorScopes) {
-    // Direct scope match
-    if (typeof uiSchema.scope === 'string' &&
-        errorScopes.includes(uiSchema.scope)) {
-        return true;
-    }
-    // Check composite children via options.childElements
-    const options = uiSchema.options;
-    const childElements = options === null || options === void 0 ? void 0 : options.childElements;
-    if (Array.isArray(childElements)) {
-        for (const child of childElements) {
-            if (uiSchemaHasAnyError(child, errorScopes)) {
-                return true;
-            }
-        }
-    }
-    // Check layout children (elements)
-    if (Array.isArray(uiSchema.elements)) {
-        for (const el of uiSchema.elements) {
-            if (uiSchemaHasAnyError(el, errorScopes)) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
-function extractErrorScopes(errors) {
-    var _a;
-    const scopes = new Set();
-    for (const error of errors) {
-        if (error.keyword === 'required' && ((_a = error.params) === null || _a === void 0 ? void 0 : _a.missingProperty)) {
-            const basePath = error.instancePath || '';
-            const prop = error.params.missingProperty;
-            // Normalize the base path
-            const fullPath = basePath === '' ? `#/properties/${prop}` : `#${basePath}/properties/${prop}`;
-            scopes.add(fullPath);
-        }
-        else if (error.instancePath) {
-            // Remove leading slash and convert to JSON Pointer path
-            const instancePath = `#${error.instancePath.replace(/\//g, '/properties/')}`;
-            scopes.add(instancePath);
-        }
-    }
-    return Array.from(scopes);
-}

package/dist/esm/review.js

@@ -0,0 +1,63 @@
+import { __decorate } from "tslib";
+import { attr, customElement, FASTElement, observable, volatile } from '@microsoft/fast-element';
+import { foundationFormReviewStyles as styles } from './review.styles';
+import { foundationFormReviewTemplate as template } from './review.template';
+import { filterReviewSections } from './utils/review-utils';
+/**
+ * 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
+ */
+let Review = class Review extends FASTElement {
+    constructor() {
+        super(...arguments);
+        this.prefix = 'rapid';
+        /**
+         * Title shown in the review header.
+         * @public
+         */
+        this.heading = 'Review';
+        /**
+         * Sections of label/value pairs to render, grouped by their nearest UI schema `Group`.
+         * @public
+         */
+        this.sections = [];
+        /**
+         * Free-text query filtering fields by label or value. Sections with no matching
+         * fields are hidden.
+         * @internal
+         */
+        this.filterText = '';
+    }
+    /** @internal */
+    get filteredSections() {
+        return filterReviewSections(this.sections, this.filterText);
+    }
+};
+__decorate([
+    attr({ attribute: 'design-system-prefix' })
+], Review.prototype, "prefix", void 0);
+__decorate([
+    attr
+], Review.prototype, "heading", void 0);
+__decorate([
+    attr({ attribute: 'record-id' })
+], Review.prototype, "recordId", void 0);
+__decorate([
+    observable
+], Review.prototype, "sections", void 0);
+__decorate([
+    observable
+], Review.prototype, "filterText", void 0);
+__decorate([
+    volatile
+], Review.prototype, "filteredSections", null);
+Review = __decorate([
+    customElement({
+        name: 'foundation-form-review',
+        template,
+        styles,
+        shadowOptions: null,
+    })
+], Review);
+export { Review };

package/dist/esm/review.styles.js

@@ -0,0 +1,93 @@
+import { designUnit, strokeWidth } from '@microsoft/fast-components';
+import { css } from '@microsoft/fast-element';
+import { forcedColorsStylesheetBehavior } from '@microsoft/fast-foundation';
+import { SystemColors } from '@microsoft/fast-web-utilities';
+/** @internal */
+export const foundationFormReviewStyles = css `
+  foundation-form-review {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-height: 0;
+    overflow: hidden;
+  }
+
+  foundation-form-review .review-header {
+    display: flex;
+    align-items: baseline;
+    gap: calc(${designUnit} * 2px);
+    padding: calc(${designUnit} * 2px) calc(${designUnit} * 2px) calc(${designUnit} * 1px);
+    border-bottom: calc(${strokeWidth} * 1px) solid var(--neutral-stroke-rest, rgb(0 0 0 / 12%));
+  }
+
+  foundation-form-review .review-title {
+    font-size: var(--type-ramp-plus-1-font-size, 1rem);
+    line-height: var(--type-ramp-plus-1-line-height, 1.5rem);
+    font-weight: 600;
+    color: var(--neutral-foreground-rest);
+  }
+
+  foundation-form-review .review-id {
+    font-family: var(--mono-font-family, 'Courier New', Courier, monospace);
+    font-size: var(--type-ramp-base-font-size, 0.875rem);
+    color: var(--neutral-foreground-hint, rgb(0 0 0 / 60%));
+  }
+
+  foundation-form-review .review-filter {
+    padding: calc(${designUnit} * 2px);
+  }
+
+  foundation-form-review .review-filter-input {
+    width: 100%;
+  }
+
+  foundation-form-review .review-body {
+    flex: 1;
+    overflow-y: auto;
+    min-height: 0;
+    scrollbar-color: var(--neutral-stroke-rest) transparent;
+  }
+
+  foundation-form-review .review-section-header {
+    font-size: var(--type-ramp-minus-1-font-size, 0.75rem);
+    line-height: var(--type-ramp-minus-1-line-height, 1rem);
+    font-weight: 600;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+    color: var(--neutral-foreground-hint, rgb(0 0 0 / 60%));
+    background-color: var(--neutral-layer-2, rgb(0 0 0 / 4%));
+    padding: calc(${designUnit} * 1px) calc(${designUnit} * 2px);
+    margin-top: calc(${designUnit} * 3px);
+  }
+
+  foundation-form-review .review-field {
+    display: flex;
+    align-items: baseline;
+    justify-content: space-between;
+    gap: calc(${designUnit} * 2px);
+    padding: calc(${designUnit} * 1.5px) calc(${designUnit} * 2px);
+    border-bottom: calc(${strokeWidth} * 1px) solid var(--neutral-stroke-rest, rgb(0 0 0 / 12%));
+  }
+
+  foundation-form-review .review-field:last-child {
+    border-bottom: none;
+  }
+
+  foundation-form-review .review-field-label {
+    color: var(--neutral-foreground-hint, rgb(0 0 0 / 60%));
+    font-size: var(--type-ramp-base-font-size, 0.875rem);
+    flex-shrink: 0;
+  }
+
+  foundation-form-review .review-field-value {
+    color: var(--neutral-foreground-rest);
+    font-size: var(--type-ramp-base-font-size, 0.875rem);
+    text-align: right;
+    word-break: break-word;
+    white-space: pre-wrap;
+  }
+`.withBehaviors(forcedColorsStylesheetBehavior(css `
+    foundation-form-review {
+      background: ${SystemColors.Canvas};
+    }
+  `));

package/dist/esm/review.template.js

@@ -0,0 +1,38 @@
+import { sync } from '@genesislcap/foundation-utils';
+import { html, repeat, when } from '@microsoft/fast-element';
+/** @internal */
+export const getPrefixedReview = (prefix) => html `
+  <template>
+    <div class="review-header">
+      <span class="review-title">${(x) => x.heading}</span>
+      ${when((x) => x.recordId, html `
+          <span class="review-id">${(x) => x.recordId}</span>
+        `)}
+    </div>
+    <div class="review-filter">
+      <${prefix}-text-field
+        value=${sync((x) => x.filterText, 'string', 'input')}
+        placeholder="Filter fields..."
+        class="review-filter-input"
+        data-test-id="review-filter-input"
+      ></${prefix}-text-field>
+    </div>
+    <div class="review-body">
+      ${repeat((x) => x.filteredSections, html `
+          ${when((section) => section.fields.length > 0, html `
+              <div class="review-section-header">${(section) => { var _a; return (_a = section.title) !== null && _a !== void 0 ? _a : '—'; }}</div>
+              ${repeat((section) => section.fields, html `
+                  <div class="review-field">
+                    <span class="review-field-label">${(field) => field.label}</span>
+                    <span class="review-field-value">${(field) => field.value}</span>
+                  </div>
+                `)}
+            `)}
+        `)}
+    </div>
+  </template>
+`;
+/** @internal */
+export const foundationFormReviewTemplate = html `
+  ${(x) => getPrefixedReview(x.prefix)}
+`;

package/dist/esm/utils/index.js

@@ -1,4 +1,5 @@
 export * from './csv-parser';
+export * from './review-utils';
 export * from './filters';
 export * from './logger';
 export * from './translation';

package/dist/esm/utils/review-utils.js

@@ -0,0 +1,205 @@
+import { capitalCase } from 'change-case';
+/**
+ * Flattens `buildReviewSections` output into a single ordered list.
+ * Section titles are prepended to field labels as "Title — Field".
+ */
+export function buildReviewFields(data, uiSchema, schema) {
+    return buildReviewSections(data, uiSchema, schema).flatMap((section) => section.fields.map((field) => ({
+        label: section.title ? `${section.title} — ${field.label}` : field.label,
+        value: field.value,
+    })));
+}
+/**
+ * Builds the review panel's fields grouped into sections by their nearest `Group` layout.
+ * Ungrouped fields are collected into a single section with a `null` title (rendered with
+ * a placeholder heading). Falls back to a flat, single ungrouped section when no UI schema
+ * is available.
+ */
+export function buildReviewSections(data, uiSchema, schema) {
+    const sections = [];
+    const sectionsByTitle = new Map();
+    const addField = (title, field) => {
+        let section = sectionsByTitle.get(title);
+        if (!section) {
+            section = { title, fields: [] };
+            sectionsByTitle.set(title, section);
+            sections.push(section);
+        }
+        section.fields.push(field);
+    };
+    const walk = (element, groupTitle) => {
+        var _a, _b, _c, _d, _e;
+        if (!element)
+            return;
+        if (element.type === 'Control' && element.scope) {
+            if ((_a = element.options) === null || _a === void 0 ? void 0 : _a.hidden)
+                return;
+            const match = element.scope.match(/^#\/properties\/(.+)$/);
+            if (!match)
+                return;
+            const fieldName = match[1];
+            const raw = getDataValueAtPath(data, fieldName);
+            if (raw === undefined ||
+                raw === null ||
+                raw === '' ||
+                (Array.isArray(raw) && raw.length === 0))
+                return;
+            const shortName = fieldName.split('/properties/').pop();
+            const fieldLabel = element.label || capitalCase(shortName);
+            const displayValue = (_c = (_b = resolveOptionLabel(raw, element.options)) !== null && _b !== void 0 ? _b : resolveEnumLabel(raw, fieldName, schema)) !== null && _c !== void 0 ? _c : raw;
+            addField(groupTitle, { label: fieldLabel, value: formatValueForReview(displayValue) });
+            return;
+        }
+        const nextGroup = element.type === 'Group' && element.label ? element.label : groupTitle;
+        const children = (_d = element.elements) !== null && _d !== void 0 ? _d : (_e = element.options) === null || _e === void 0 ? void 0 : _e.childElements;
+        if (children) {
+            for (const child of children) {
+                walk(child, nextGroup);
+            }
+        }
+    };
+    if (uiSchema) {
+        walk(uiSchema, null);
+    }
+    else {
+        for (const [key, raw] of Object.entries(data !== null && data !== void 0 ? data : {})) {
+            if (raw === undefined || raw === null || raw === '')
+                continue;
+            addField(null, { label: capitalCase(key), value: formatValueForReview(raw) });
+        }
+    }
+    return sections;
+}
+/**
+ * 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.
+ */
+export function filterReviewSections(sections, query) {
+    const normalized = query.trim().toLowerCase();
+    if (!normalized)
+        return sections;
+    return sections
+        .map((section) => ({
+        title: section.title,
+        fields: section.fields.filter((field) => field.label.toLowerCase().includes(normalized) ||
+            field.value.toLowerCase().includes(normalized)),
+    }))
+        .filter((section) => section.fields.length > 0);
+}
+/**
+ * Recursively walks a UI schema element, collecting visible Control fields into `out`.
+ * Passes the nearest Group label down so children are labelled "Group — Field".
+ */
+export function collectReviewFields(element, data, out, groupLabel, schema) {
+    var _a, _b, _c, _d, _e;
+    if (element.type === 'Control' && element.scope) {
+        if ((_a = element.options) === null || _a === void 0 ? void 0 : _a.hidden)
+            return;
+        const match = element.scope.match(/^#\/properties\/(.+)$/);
+        if (!match)
+            return;
+        const fieldName = match[1];
+        const raw = getDataValueAtPath(data, fieldName);
+        if (raw === undefined || raw === null || raw === '' || (Array.isArray(raw) && raw.length === 0))
+            return;
+        const shortName = fieldName.split('/properties/').pop();
+        const fieldLabel = element.label || capitalCase(shortName);
+        const displayValue = (_c = (_b = resolveOptionLabel(raw, element.options)) !== null && _b !== void 0 ? _b : resolveEnumLabel(raw, fieldName, schema)) !== null && _c !== void 0 ? _c : raw;
+        out.push({
+            label: groupLabel ? `${groupLabel} — ${fieldLabel}` : fieldLabel,
+            value: formatValueForReview(displayValue),
+        });
+        return;
+    }
+    const nextGroup = element.type === 'Group' && element.label ? element.label : groupLabel;
+    const children = (_d = element.elements) !== null && _d !== void 0 ? _d : (_e = element.options) === null || _e === void 0 ? void 0 : _e.childElements;
+    if (children) {
+        for (const child of children) {
+            collectReviewFields(child, data, out, nextGroup, schema);
+        }
+    }
+}
+/**
+ * Looks up the display label for a raw value from `options.data` (used by segmented,
+ * radio group, and enum-with-explicit-data renderers). Returns `null` when no match found.
+ */
+export function resolveOptionLabel(raw, options) {
+    var _a;
+    if (!Array.isArray(options === null || options === void 0 ? void 0 : options.data))
+        return null;
+    const entry = options.data.find((item) => item.value === raw);
+    return (_a = entry === null || entry === void 0 ? void 0 : entry.label) !== null && _a !== void 0 ? _a : null;
+}
+/**
+ * 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.
+ */
+export function resolveEnumLabel(raw, fieldName, schema) {
+    var _a, _b, _c, _d;
+    if (typeof raw !== 'string')
+        return null;
+    if (!(schema === null || schema === void 0 ? void 0 : schema.properties))
+        return null;
+    let fieldSchema = schema;
+    for (const part of fieldName.split('/properties/')) {
+        fieldSchema = (_a = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.properties) === null || _a === void 0 ? void 0 : _a[part];
+    }
+    if (!fieldSchema)
+        return null;
+    // Matches plain `enum: [...]` or nullable `oneOf: [{ enum: [...] }, { type: 'null' }]`
+    const enumValues = (_b = fieldSchema.enum) !== null && _b !== void 0 ? _b : (_d = (_c = fieldSchema.oneOf) === null || _c === void 0 ? void 0 : _c.find((x) => x.enum)) === null || _d === void 0 ? void 0 : _d.enum;
+    if (Array.isArray(enumValues) && enumValues.includes(raw)) {
+        return capitalCase(raw);
+    }
+    return null;
+}
+/**
+ * Navigates a `/properties/`-separated path in data to support nested object scopes
+ * such as `ADDRESS/properties/STREET` produced by Group layout UI schemas.
+ */
+export function getDataValueAtPath(data, fieldName) {
+    return navigateSegments(data, fieldName.split('/properties/'));
+}
+/** Core traversal — walks `data` one property key at a time. */
+function navigateSegments(data, segments) {
+    let value = data;
+    for (const segment of segments) {
+        if (value == null)
+            return undefined;
+        value = value[segment];
+    }
+    return value;
+}
+/**
+ * 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.
+ */
+export function formatValueForReview(value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '';
+        if (value.every((v) => v === null || typeof v !== 'object')) {
+            return value.join(', ');
+        }
+        return value
+            .map((item, i) => {
+            const pairs = Object.entries(item !== null && item !== void 0 ? item : {})
+                .filter(([, v]) => v !== null && v !== undefined && v !== '')
+                .map(([k, v]) => `${k}: ${v}`)
+                .join(', ');
+            return `[${i + 1}] ${pairs}`;
+        })
+            .join('\n');
+    }
+    if (typeof value === 'object') {
+        return Object.entries(value)
+            .filter(([, v]) => v !== null && v !== undefined && v !== '')
+            .map(([k, v]) => `${k}: ${v}`)
+            .join(', ');
+    }
+    return String(value);
+}

package/dist/esm/utils/schema-utils.js

@@ -93,6 +93,54 @@ export function isBulkUiSchema(uischema) {
     var _a;
     return (_a = uischema === null || uischema === void 0 ? void 0 : uischema.elements) === null || _a === void 0 ? void 0 : _a.some((element) => element.scope === '#/properties/items' && element.type === 'Control');
 }
+/**
+ * Converts AJV validation errors to the JSON Schema scope strings they correspond to
+ * (e.g. `#/properties/ADDRESS/properties/STREET`). Used to match errors back to UI
+ * schema controls for features like categorization-tab error indicators.
+ */
+export function extractErrorScopes(errors) {
+    var _a;
+    const scopes = new Set();
+    for (const error of errors) {
+        if (error.keyword === 'required' && ((_a = error.params) === null || _a === void 0 ? void 0 : _a.missingProperty)) {
+            const basePath = error.instancePath || '';
+            const prop = error.params.missingProperty;
+            const fullPath = basePath === '' ? `#/properties/${prop}` : `#${basePath}/properties/${prop}`;
+            scopes.add(fullPath);
+        }
+        else if (error.instancePath) {
+            // Convert JSON Pointer /ADDRESS/STREET → #/properties/ADDRESS/properties/STREET
+            const instancePath = `#${error.instancePath.replace(/\//g, '/properties/')}`;
+            scopes.add(instancePath);
+        }
+    }
+    return Array.from(scopes);
+}
+/**
+ * Returns true when `uiSchema` (or any of its descendants) has a scope that appears
+ * in `errorScopes`. Walks both `elements` and `options.childElements`.
+ */
+export function uiSchemaHasAnyError(uiSchema, errorScopes) {
+    var _a;
+    if (typeof uiSchema.scope === 'string' &&
+        errorScopes.includes(uiSchema.scope)) {
+        return true;
+    }
+    const childElements = (_a = uiSchema.options) === null || _a === void 0 ? void 0 : _a.childElements;
+    if (Array.isArray(childElements)) {
+        for (const child of childElements) {
+            if (uiSchemaHasAnyError(child, errorScopes))
+                return true;
+        }
+    }
+    if (Array.isArray(uiSchema.elements)) {
+        for (const el of uiSchema.elements) {
+            if (uiSchemaHasAnyError(el, errorScopes))
+                return true;
+        }
+    }
+    return false;
+}
 /**
  * Generates a UI schema suitable for bulk insert mode with array control.
  * @param userProvidedUiSchema - Optional user-provided UI schema to use as childUiSchema