@incodetech/prizma-core-screens 0.2.3 → 0.2.7

package/dist/EkybStrings.d.ts

@@ -7,13 +7,19 @@
  * - `dropdown` — the same selection with the MENU OPEN over the form: search
  *   bar plus the country rows (Core's documentation-only `forceOpen`, since a
  *   screen is one static spec state and never a live interaction)
+ * - `emptyError` — Continue was pressed with no country chosen (GUIDELINES
+ *   §6-E empty-submit rule, Elena 2026-09-30): the dropdown in Core's error
+ *   state with `requiredError`, Continue disabled. Not a Figma frame.
  */
-export type EkybCountryState = 'empty' | 'filled' | 'dropdown';
+export type EkybCountryState = 'empty' | 'filled' | 'dropdown' | 'emptyError';
 /** The two `eKYB.Bdetails` (business identity) sections: every field on its
- *  resting empty surface, or every field carrying a value. */
-export type EkybBusinessState = 'empty' | 'filled';
-/** The two address sections (the SECOND `eKYB.Bdetails` parent). Same axis. */
-export type EkybAddressState = 'empty' | 'filled';
+ *  resting empty surface, or every field carrying a value — plus `emptyError`,
+ *  Continue pressed with the fields empty (empty-submit rule, 2026-09-30):
+ *  every required field in Core's error state, Continue disabled. */
+export type EkybBusinessState = 'empty' | 'filled' | 'emptyError';
+/** The two address sections (the SECOND `eKYB.Bdetails` parent). Same axis,
+ *  same `emptyError` (the optional Address line 2 shows no error). */
+export type EkybAddressState = 'empty' | 'filled' | 'emptyError';
 /**
  * The `eKYB.UBO.*` and `eKYB.director.*` sections — one screen family, because
  * measured against the 390 frames the director frames ARE the UBO frames with
@@ -33,8 +39,13 @@ export type EkybAddressState = 'empty' | 'filled';
  *   flight, so EVERY field, both "Add another" links and "Back" go inert and
  *   the spinner rides the CTA, never a field (the Phone Input lesson,
  *   DEVIATIONS #PI-5)
+ * - `uboEmptyError` / `directorEmptyError` — `uboEmpty` / `directorEmpty` after
+ *   Continue was pressed with the fields empty (GUIDELINES §6-E empty-submit
+ *   rule, Elena 2026-09-30): the two REQUIRED UBO fields in Core's error state
+ *   with `requiredError`, the optional Director fields unflagged, Continue
+ *   disabled. Not Figma frames.
  */
-export type EkybOwnersState = 'uboEmpty' | 'uboFilled' | 'directorEmpty' | 'directorFilled' | 'uboAdded' | 'loading';
+export type EkybOwnersState = 'uboEmpty' | 'uboFilled' | 'directorEmpty' | 'directorFilled' | 'uboAdded' | 'loading' | 'uboEmptyError' | 'directorEmptyError';
 /**
  * One selectable row in the country / state menus. Runtime data, not copy — the
  * host owns the catalogue (an ISO country list is ~250 entries and a state list
@@ -47,9 +58,8 @@ export interface EkybOption {
     /** The row label as drawn in the open menu. */
     label: string;
     /** Compact face for the CLOSED field when it differs from the menu row —
-     *  Core's own `PrizmaDropdownOption.fieldLabel`. `eKYB.country.dropdown`
-     *  draws "🇺🇸 +1 United States" in the row and "🇺🇸 United States" in the
-     *  field. */
+     *  Core's own `PrizmaDropdownOption.fieldLabel`. The eKYB country list
+     *  does not need it: rows and field both read "🇺🇸 United States". */
     fieldLabel?: string;
 }
 /** The values the business-identity page carries. Runtime data, never copy. */
@@ -97,6 +107,13 @@ export interface EkybStrings {
      * localizable and never hardcoded in a screen.
      */
     requiredHint?: string;
+    /**
+     * Under every empty REQUIRED field once the primary was pressed with it
+     * still empty — the `emptyError` states (GUIDELINES §6-E empty-submit rule,
+     * Elena 2026-09-30). Core's own `errorText` slot; SDK key
+     * `dynamicForms.fieldRequired`.
+     */
+    requiredError: string;
     /** Shared "Back" secondary action drawn under "Continue" on every page except
      *  `country`. Emits `secondary`. */
     backLabel: string;
@@ -170,7 +187,7 @@ export interface EkybStrings {
         title: string;
         subtitle?: string;
         uboName: EkybFieldStrings;
-        /** Figma draws NO `*` on the surname — it is optional. */
+        /** Required, like the name (Elena, 2026-09-28); the frames drew no `*`. */
         uboSurname: EkybFieldStrings;
         /** The tertiary link under the UBO block ("Add another UBO (Optional)"). */
         addUboLabel: string;

package/dist/EkycCountryCatalog.d.ts

@@ -1,4 +1,7 @@
-export type EkycFieldKind = 'text' | 'date' | 'phone' | 'dropdown' | 'radio';
+/** `password`: Core's `PrizmaPassword`, the field with the eye that hides the
+ *  typed value. For the identifiers a stranger must not read over a shoulder:
+ *  the SSN / ITIN fields (Elena, 2026-09-28). No requirement checklist. */
+export type EkycFieldKind = 'text' | 'date' | 'phone' | 'dropdown' | 'radio' | 'password';
 export type EkycFieldKey = 'firstName' | 'middleName' | 'middleNameOptional' | 'lastName' | 'surname' | 'maternalSurname' | 'dateOfBirth' | 'email' | 'phone' | 'ssnLast4' | 'ssnOrItin' | 'nationality' | 'cpf' | 'nationalId' | 'taxId' | 'gender' | 'licenseNumber' | 'licenseState' | 'licenseExpiration' | 'street' | 'houseNumber' | 'city' | 'state' | 'stateCode' | 'zipCode' | 'postalCode';
 export interface EkycField {
     key: EkycFieldKey;

package/dist/EkycCountryCatalog.js

@@ -20,6 +20,8 @@
 // Verification", and no variant draws a close in the nav; steps after the
 // first get the archetype's Back button instead of a back arrow (#EKC-2).
 const t = (key, extra = {}) => ({ key, kind: 'text', ...extra });
+/** A hidden-by-default identifier, with the eye to reveal it. */
+const secret = (key, extra = {}) => ({ key, kind: 'password', ...extra });
 const date = (key = 'dateOfBirth', extra = {}) => ({ key, kind: 'date', ...extra });
 // Required fields carry Core's asterisk (`required` + `requiredHint`), the
 // owner's rule (Elena, 2026-09-24, DEVIATIONS #EKC-6): first name, last name or
@@ -54,7 +56,7 @@ export const EKYC_COUNTRY_CATALOG = [
     {
         id: 'us-telco-1', country: 'US', label: 'United States', provider: 'Telco 1', stepper: 3,
         steps: [
-            { node: '2098:9575', fields: [...NAME_PAIR(), email(), ...DOB_PHONE('US'), t('ssnLast4')] },
+            { node: '2098:9575', fields: [...NAME_PAIR(), email(), ...DOB_PHONE('US'), secret('ssnLast4')] },
             { node: '5854:76222', section: 'license', fields: [t('licenseNumber'), { key: 'licenseState', kind: 'dropdown', placeholder: 'selectState' }] },
             { node: '5854:76221', section: 'address', fields: US_ADDRESS },
         ],
@@ -71,7 +73,7 @@ export const EKYC_COUNTRY_CATALOG = [
         steps: [
             /* Same First | Last pair as the licence variant; Middle name (Optional)
                follows it and spans (#EKC-5). */
-            { node: '2098:9577', fields: [...NAME_PAIR(), t('middleNameOptional'), ...DOB_PHONE('US'), email(), t('ssnOrItin')] },
+            { node: '2098:9577', fields: [...NAME_PAIR(), t('middleNameOptional'), ...DOB_PHONE('US'), email(), secret('ssnOrItin')] },
             { node: '5857:34094', section: 'address', fields: US_ADDRESS },
         ],
     },
@@ -90,7 +92,7 @@ export const EKYC_COUNTRY_CATALOG = [
     {
         id: 'ca-res-credit', country: 'CA', label: 'Canada', provider: 'Residential credit', stepper: 2,
         steps: [
-            { node: '2098:9570', fields: [...NAME_PAIR(), email(), ...DOB_PHONE('CA'), t('ssnOrItin')] },
+            { node: '2098:9570', fields: [...NAME_PAIR(), email(), ...DOB_PHONE('CA'), secret('ssnOrItin')] },
             { node: '5857:36450', section: 'address', fields: CODE_ADDRESS('stateCodeCa') },
         ],
     },

package/dist/EkycCountryFormScreen.d.ts

@@ -16,11 +16,20 @@ export interface EkycCountryFormScreenProps extends Omit<PrizmaFormScreenProps,
     values?: EkycCountryValues;
     /**
      * The state after Continue was pressed with fields still empty: every empty
-     * field shows Core's error state and `country.requiredError` under it.
-     * Continue itself is ALWAYS enabled (Elena, 2026-09-24): validation happens
-     * on press, not by greying the button.
+     * REQUIRED field shows Core's error state and `country.requiredError` under
+     * it, and Continue is disabled (GUIDELINES §6-E empty-submit rule, Elena
+     * 2026-09-30). Without it Continue stays enabled: validation happens on
+     * press, the resting page never greys the button.
      */
     showErrors?: boolean;
+    /**
+     * Field keys whose typed value failed the format check on Continue (an
+     * invalid CPF, say). Each keeps its value, shows Core's error state and
+     * `country.invalidErrors[key]` under it; Continue stays enabled so the user
+     * corrects it and presses again, the CURP precedent (`CurpEnterScreen`'s
+     * `invalid`). A key with no message in `invalidErrors` shows no error.
+     */
+    invalidFields?: string[];
     /** Dial codes the phone field offers. Runtime data, never copy. */
     phoneCountries?: PrizmaCountry[];
     /** Options for the dropdown fields, keyed by field key. Runtime data. */

package/dist/EkycCountryFormScreen.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef } from 'react';
 import { PrizmaTextField } from '@incodetech/prizma-core-web/text-field';
+import { PrizmaPassword } from '@incodetech/prizma-core-web/password';
 import { PrizmaDateField } from '@incodetech/prizma-core-web/date-field';
 import { PrizmaDropdown } from '@incodetech/prizma-core-web/dropdown';
 import { PrizmaCombined } from '@incodetech/prizma-core-web/combined';
@@ -23,10 +24,13 @@ import './EkycLayout.css';
  * dropdown, radio pair — so a new country is a catalogue entry, never a file.
  *
  * Deliberate, per frame and per owner:
- * - Continue is ALWAYS enabled (Elena, 2026-09-24, overriding the grey button
- *   most frames draw): pressing it with empty fields is the `showErrors` state,
- *   Core's error ring and message under each empty field. The radio pair has
- *   no error state in Core, so an empty gender shows none (DEVIATIONS #EKC-4).
+ * - Continue is enabled on the resting page (Elena, 2026-09-24, overriding the
+ *   grey button most frames draw): pressing it with empty fields is the
+ *   `showErrors` state, Core's error ring and message under each empty
+ *   required field, and THEN Continue is disabled. The "always enabled" half
+ *   of DEVIATIONS #EKC-4 is superseded by the 2026-09-30 empty-submit rule
+ *   (GUIDELINES §6-E). The radio pair has no error state in Core, so an empty
+ *   gender still shows none.
  * - ONE title per step (Elena, 2026-09-24): the personal-data step is "Enter
  *   your details" with its subtitle; a licence step is titled "Driver's
  *   License details" and an address step "Address details", with nothing
@@ -53,7 +57,7 @@ const groupRows = (fields) => {
     }
     return groups;
 };
-export const EkycCountryFormScreen = forwardRef(({ strings, variant, step = 1, values, showErrors = false, phoneCountries, options, screenId, overrides, onAction, ...shell }, ref) => {
+export const EkycCountryFormScreen = forwardRef(({ strings, variant, step = 1, values, showErrors = false, invalidFields, phoneCountries, options, screenId, overrides, onAction, ...shell }, ref) => {
     const v = typeof variant === 'string' ? ekycCountryVariant(variant) : variant;
     if (!v)
         return null;
@@ -61,14 +65,21 @@ export const EkycCountryFormScreen = forwardRef(({ strings, variant, step = 1, v
     const c = strings.country;
     const stepperState = step <= 1 ? 'Start' : Math.min(step, 6);
     const label = (f) => c.fields[f.key] ?? f.key;
-    const placeholder = (f) => (f.placeholder ? c.placeholders[f.placeholder] : c.placeholders[f.key]);
+    // A lone field in its empty-submit error drops its placeholder, as the
+    // single-input screens do (Phone, Email and CURP's `emptyError`).
+    const lone = s.fields.length === 1;
+    const placeholder = (f) => lone && showErrors && !values?.[f.key] ? undefined : f.placeholder ? c.placeholders[f.placeholder] : c.placeholders[f.key];
     const renderField = (f) => {
         // Only a REQUIRED empty field is an error on press (Elena, 2026-09-24,
-        // DEVIATIONS #EKC-6): an optional field left blank shows nothing.
-        const missing = showErrors && Boolean(f.required) && !values?.[f.key];
+        // DEVIATIONS #EKC-6): an optional field left blank shows nothing. A
+        // step's lone field is required by definition, asterisk or not (the
+        // single-input rule, as Phone and Email Input: Elena, 2026-10-02).
+        const required = Boolean(f.required) || lone;
+        const missing = showErrors && required && !values?.[f.key];
+        const invalidText = invalidFields?.includes(f.key) ? c.invalidErrors?.[f.key] : undefined;
         const common = {
             key: f.key, label: label(f), required: f.required, requiredHint: strings.details.requiredHint,
-            error: missing || undefined, errorText: missing ? c.requiredError : undefined,
+            error: missing || Boolean(invalidText) || undefined, errorText: missing ? c.requiredError : invalidText,
         };
         switch (f.kind) {
             case 'date':
@@ -79,13 +90,20 @@ export const EkycCountryFormScreen = forwardRef(({ strings, variant, step = 1, v
             }
             case 'dropdown':
                 return (_jsx(PrizmaDropdown, { ...common, placeholder: placeholder(f), options: options?.[f.key] ?? [], defaultValue: values?.[f.key] ?? null }));
+            case 'password':
+                /* The SSN / ITIN fields: Core's Password field, hidden by default, the
+                   eye reveals it. No requirement checklist — this is an identifier,
+                   not a password to compose (Elena, 2026-09-28). */
+                return (_jsx(PrizmaPassword, { ...common, placeholder: placeholder(f), autoComplete: "off", defaultValue: values?.[f.key] ?? '', showPasswordLabel: c.showValueLabel, hidePasswordLabel: c.hideValueLabel, showHelper: false, showRequirements: false }));
             case 'radio':
                 return (_jsx(PrizmaRadioGroup, { name: f.key, legend: label(f), defaultValue: values?.[f.key], className: "ekyc-country__radios", children: c.genderOptions.map(o => (_jsx(PrizmaRadio, { value: o.value, textSize: "m", showText: true, text: o.label }, o.value))) }, f.key));
             default:
                 return _jsx(PrizmaTextField, { ...common, placeholder: placeholder(f), autoComplete: "off", defaultValue: values?.[f.key] ?? '' });
         }
     };
-    return (_jsx(PrizmaFormScreen, { ref: ref, scrollFields: true, progress: v.stepper > 0 ? (_jsx(PrizmaStepper, { steps: v.stepper, currentState: stepperState, showIcons: false, "aria-label": strings.stepperLabel })) : undefined, title: s.section === 'address' ? c.addressSection : s.section === 'license' ? c.licenseSection : strings.details.title, subtitle: s.section ? undefined : strings.details.subtitle, linkContent: step > 1 ? (_jsx(PrizmaButton, { variant: "secondary", size: "L", onClick: () => onAction?.({ type: 'secondary', screenId }), children: c.backLabel })) : undefined, ctaLabel: c.ctaLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: { align: overrides?.align ?? 'left', logo: overrides?.logo }, onAction: onAction, 
+    return (_jsx(PrizmaFormScreen, { ref: ref, scrollFields: true, progress: v.stepper > 0 ? (_jsx(PrizmaStepper, { steps: v.stepper, currentState: stepperState, showIcons: false, "aria-label": strings.stepperLabel })) : undefined, title: s.section === 'address' ? c.addressSection : s.section === 'license' ? c.licenseSection : strings.details.title, subtitle: s.section ? undefined : strings.details.subtitle, linkContent: step > 1 ? (_jsx(PrizmaButton, { variant: "secondary", size: "L", onClick: () => onAction?.({ type: 'secondary', screenId }), children: c.backLabel })) : undefined, ctaLabel: c.ctaLabel, 
+        /* Greyed only after the empty submit (2026-09-30 empty-submit rule). */
+        ctaDisabled: showErrors, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: { align: overrides?.align ?? 'left', logo: overrides?.logo }, onAction: onAction, 
         /* The eKYB desktop shape: catalogue pairs become two lanes at 420 and
            up, Back | Continue share a row. The phone stack is untouched. */
         responsive: true, ...shell, children: groupRows(s.fields).map(group => group.length > 1 ? (_jsx(PrizmaFormRow, { children: group.map(renderField) }, group.map(f => f.key).join('+'))) : (renderField(group[0]))) }));

package/dist/EkycDetailsScreen.d.ts

@@ -52,6 +52,13 @@ export interface EkycDetailsScreenProps extends Omit<PrizmaFormScreenProps, 'tit
  * the label row Figma draws as "First name *" — so Middle name, the one
  * optional field, correctly renders none.
  *
+ * `emptyError` is the state after Continue was pressed with the fields still
+ * empty (Elena, 2026-09-30, GUIDELINES §6-E empty-submit rule; drawn precedent
+ * `FormsFieldScreen`'s `emptyError`): every field renders empty, the three
+ * REQUIRED ones carry Core's `error` + `country.requiredError`, Middle name
+ * stays unflagged (DEVIATIONS #EKC-6), and Continue is disabled. The resting
+ * `default` keeps Continue enabled so the press can happen at all.
+ *
  * Figma draws a two-segment journey bar between the nav and the title on every
  * page-1 frame, and it is the only chrome that separates page 1 from page 2.
  * Archetype E had no slot above the title; the gap is now CLOSED in the

package/dist/EkycDetailsScreen.js

@@ -44,6 +44,13 @@ import './EkycLayout.css';
  * the label row Figma draws as "First name *" — so Middle name, the one
  * optional field, correctly renders none.
  *
+ * `emptyError` is the state after Continue was pressed with the fields still
+ * empty (Elena, 2026-09-30, GUIDELINES §6-E empty-submit rule; drawn precedent
+ * `FormsFieldScreen`'s `emptyError`): every field renders empty, the three
+ * REQUIRED ones carry Core's `error` + `country.requiredError`, Middle name
+ * stays unflagged (DEVIATIONS #EKC-6), and Continue is disabled. The resting
+ * `default` keeps Continue enabled so the press can happen at all.
+ *
  * Figma draws a two-segment journey bar between the nav and the title on every
  * page-1 frame, and it is the only chrome that separates page 1 from page 2.
  * Archetype E had no slot above the title; the gap is now CLOSED in the
@@ -53,11 +60,18 @@ import './EkycLayout.css';
  * solid brand blue and segment 2 grey, i.e. `steps={2} currentState="Start"`,
  * with the icons row off (the frames draw the bar alone). DEVIATIONS #EK-1.
  */
-export const EkycDetailsScreen = forwardRef(({ strings, state = 'default', values, screenId = `ekyc-details-${state}`, className, overrides, onAction, ...shell }, ref) => {
+export const EkycDetailsScreen = forwardRef(({ strings, state = 'default', values: valuesProp, screenId = `ekyc-details-${state}`, ctaDisabled, className, overrides, onAction, ...shell }, ref) => {
     // The one field treatment that varies across the three sections: 2101:8159
     // rings First name blue and shows its clear ✕; the other two draw every
     // field resting.
     const focused = state === 'focused';
+    // The empty-submit state: every field empty, required ones in error.
+    const emptyError = state === 'emptyError';
+    const values = emptyError ? undefined : valuesProp;
+    // Core's own error treatment, spread onto the REQUIRED fields only.
+    const missing = emptyError
+        ? { error: true, errorText: strings.country.requiredError }
+        : {};
     return (_jsxs(PrizmaFormScreen, { ref: ref, 
         /* Scopes the single rule that lets the focused field keep the clear ✕
            Figma draws inside it. See EkycLayout.css. */
@@ -68,7 +82,10 @@ export const EkycDetailsScreen = forwardRef(({ strings, state = 'default', value
            `Start` state at `steps={2}`. `showIcons={false}` because the frames
            draw the bar with no glyph row (and it keeps the icon lookup, which
            has no id+2 sequence, out of the render entirely). */
-        progress: _jsx(PrizmaStepper, { steps: 2, currentState: "Start", showIcons: false, "aria-label": strings.stepperLabel }), title: strings.details.title, subtitle: strings.details.subtitle, ctaLabel: strings.details.ctaLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, 
+        progress: _jsx(PrizmaStepper, { steps: 2, currentState: "Start", showIcons: false, "aria-label": strings.stepperLabel }), title: strings.details.title, subtitle: strings.details.subtitle, ctaLabel: strings.details.ctaLabel, 
+        /* Disabled only after the empty submit; the resting page keeps it
+           enabled so the press can happen. */
+        ctaDisabled: emptyError || ctaDisabled, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, 
         /* Every eKYC form frame LEFT-aligns its title block, while the archetype
            defaults to centred. The module supplies its designed alignment through
            the sanctioned override rather than declaring any layout, and a host
@@ -80,9 +97,9 @@ export const EkycDetailsScreen = forwardRef(({ strings, state = 'default', value
            now FOLLOWS Last name, on the phone too (First, Last, Middle, Date of
            birth), the one order change the pairing costs: the frames drew
            First, Middle, Last. DEVIATIONS #EKC-5. */
-        responsive: true, ...shell, children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { className: focused ? 'prizma-input-textfield--focused' : undefined, label: strings.details.firstNameLabel, required: true, requiredHint: strings.details.requiredHint, defaultValue: values?.firstName ?? '', autoComplete: "off", 
+        responsive: true, ...shell, children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { className: focused ? 'prizma-input-textfield--focused' : undefined, label: strings.details.firstNameLabel, required: true, requiredHint: strings.details.requiredHint, ...missing, defaultValue: values?.firstName ?? '', autoComplete: "off", 
                         /* Only 2101:8159 draws the ✕, and only in this field. */
-                        clearable: focused, clearLabel: strings.details.clearLabel }), _jsx(PrizmaTextField, { label: strings.details.lastNameLabel, required: true, requiredHint: strings.details.requiredHint, defaultValue: values?.lastName ?? '', autoComplete: "off", clearable: false })] }), _jsx(PrizmaTextField, { label: strings.details.middleNameLabel, defaultValue: values?.middleName ?? '', autoComplete: "off", clearable: false }), _jsx(PrizmaDateField, { label: strings.details.dateOfBirthLabel, required: true, requiredHint: strings.details.requiredHint, defaultValue: values?.dateOfBirth ?? '', autoComplete: "off" })] }));
+                        clearable: focused, clearLabel: strings.details.clearLabel }), _jsx(PrizmaTextField, { label: strings.details.lastNameLabel, required: true, requiredHint: strings.details.requiredHint, ...missing, defaultValue: values?.lastName ?? '', autoComplete: "off", clearable: false })] }), _jsx(PrizmaTextField, { label: strings.details.middleNameLabel, defaultValue: values?.middleName ?? '', autoComplete: "off", clearable: false }), _jsx(PrizmaDateField, { label: strings.details.dateOfBirthLabel, required: true, requiredHint: strings.details.requiredHint, ...missing, defaultValue: values?.dateOfBirth ?? '', autoComplete: "off" })] }));
 });
 EkycDetailsScreen.displayName = 'EkycDetailsScreen';
 export default EkycDetailsScreen;

package/dist/EkycStrings.d.ts

@@ -9,8 +9,12 @@
  *               the clear ✕ (2101:8159 draws the OS keyboard over the CTA; the
  *               keyboard is OS chrome, never a screen element)
  * - `filled`  — all four fields resting with their values
+ * - `emptyError` — Continue was pressed with the fields empty (GUIDELINES §6-E
+ *               empty-submit rule, Elena 2026-09-30): the three REQUIRED fields
+ *               in Core's error state with `country.requiredError`, Middle name
+ *               (optional) unflagged, and Continue disabled. Not a Figma frame.
  */
-export type EkycDetailsState = 'default' | 'focused' | 'filled';
+export type EkycDetailsState = 'default' | 'focused' | 'filled' | 'emptyError';
 /**
  * The page-2 sections (`eKYC.default` / `eKYC.filled` / `eKYC.loading`), same
  * layout with the document field set:
@@ -109,6 +113,10 @@ export interface EkycStrings {
         licenseSection: string;
         /** Accessible name of the phone field's dial-code list. */
         countryListLabel: string;
+        /** Accessible names for the eye on a `password` field (the SSN / ITIN
+         *  fields): while the value is hidden, and while it is shown. */
+        showValueLabel: string;
+        hideValueLabel: string;
         /** The gender radio pair, Argentina. */
         genderOptions: {
             value: string;
@@ -119,8 +127,12 @@ export interface EkycStrings {
         ctaLabel: string;
         /** The secondary button on a step after the first. */
         backLabel: string;
-        /** Under every empty field once Continue was pressed (`showErrors`). */
+        /** Under every empty REQUIRED field once Continue was pressed: the
+         *  by-country `showErrors` state and page 1's `emptyError` both read it. */
         requiredError: string;
+        /** Under a field whose value failed the format check on Continue, by
+         *  field key (`invalidFields`). `cpf` is SDK key `dynamicForms.invalidCpf`. */
+        invalidErrors?: Record<string, string>;
     };
     /** `eKYC.processing` — spinner over the status line, no button. */
     processing: {

package/dist/ElectronicSignatureLayout.css

@@ -47,6 +47,12 @@
   border: var(--prizma-border-width-regular) solid var(--prizma-border-neutral-100);
   border-radius: var(--prizma-border-radius-small);
   text-align: start;
+  /* Air between the frame and the CTA band. Archetype G's list middle carries
+     no bottom gap (its content normally ends well above the band), so a frame
+     that fills the middle sat flush against Continue (owner-reported
+     2026-09-29). Spacing/16 is the archetype's own scrolling-middle → band gap
+     (`.prizma-screen-layout__list--scroll`, ScreenLayout.css). */
+  margin-bottom: var(--prizma-spacing-16);
 }
 
 /* The agreement's own typography — Body/M Regular on Text/Body/500, the pair

package/dist/EmailInputStrings.d.ts

@@ -8,8 +8,12 @@
  * - `filled`  — focused field with a complete address
  * - `error`   — negative field + clear ✕ + the invalid-format row
  * - `loading` — field greyed while the code is requested, spinner in the CTA
+ * - `emptyError` — "Continue" pressed with the field still empty: the field
+ *   stays empty (no placeholder) in Core's error state with `requiredError`,
+ *   and the CTA is disabled. GUIDELINES §6-E empty-submit rule (Elena,
+ *   2026-09-30).
  */
-export type EmailInputVerifyState = 'default' | 'typing' | 'filled' | 'error' | 'loading';
+export type EmailInputVerifyState = 'default' | 'typing' | 'filled' | 'error' | 'loading' | 'emptyError';
 /**
  * The `email.OTP.*` sections — same layout, different code-field state:
  * - `typing`       — focused field, partial code, CTA enabled, and the line
@@ -27,6 +31,12 @@ export interface EmailInputStrings {
     verifiedLabel: string;
     /** Accessible name for the logo nav row. */
     navLabel?: string;
+    /**
+     * Error row under the required field when the primary CTA is pressed with it
+     * still empty (the verify screen's `emptyError` state): "This field is
+     * required". SDK key `dynamicForms.fieldRequired`.
+     */
+    requiredError: string;
     /** email.verifyEmail.* */
     verify: {
         /** H2 ("Verify your email"). */

package/dist/EmailInputVerifyScreen.d.ts

@@ -41,6 +41,13 @@ export interface EmailInputVerifyScreenProps extends Omit<PrizmaFormScreenProps,
  * paints the DISABLED surface (owner definition 2026-07-12), which would grey
  * the four resting states Figma draws white. The field is uncontrolled instead
  * (DEVIATIONS #PI-6).
+ *
+ * `emptyError` is the empty-submit state (rule from Elena, 2026-09-30,
+ * GUIDELINES §6-E empty-submit rule): "Continue" was pressed with nothing
+ * typed. The field renders empty with no placeholder, in Core's error state
+ * with `requiredError`, and the primary CTA is disabled, following the drawn
+ * precedent in `FormsFieldScreen`. The resting `default` keeps the CTA enabled
+ * so the user can reach this state.
  */
 export declare const EmailInputVerifyScreen: React.ForwardRefExoticComponent<EmailInputVerifyScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default EmailInputVerifyScreen;

package/dist/EmailInputVerifyScreen.js

@@ -31,23 +31,37 @@ import './ScreenLayout.css';
  * paints the DISABLED surface (owner definition 2026-07-12), which would grey
  * the four resting states Figma draws white. The field is uncontrolled instead
  * (DEVIATIONS #PI-6).
+ *
+ * `emptyError` is the empty-submit state (rule from Elena, 2026-09-30,
+ * GUIDELINES §6-E empty-submit rule): "Continue" was pressed with nothing
+ * typed. The field renders empty with no placeholder, in Core's error state
+ * with `requiredError`, and the primary CTA is disabled, following the drawn
+ * precedent in `FormsFieldScreen`. The resting `default` keeps the CTA enabled
+ * so the user can reach this state.
  */
 export const EmailInputVerifyScreen = forwardRef(({ strings, state = 'default', value, screenId = `email-input-verify-${state}`, overrides, onAction, ...shell }, ref) => {
     const busy = state === 'loading';
     const invalid = state === 'error';
+    // Empty submit: the field drops its placeholder and takes Core's error
+    // state with the shared "required" row; the CTA greys.
+    const emptyError = state === 'emptyError';
     const focused = state === 'typing' || state === 'filled';
     return (_jsx(PrizmaFormScreen, { ref: ref, title: strings.verify.title, subtitle: strings.verify.subtitle, ctaLabel: strings.verify.ctaLabel, 
         /* Figma's `loading` section swaps the CTA label for Core's spinner. */
-        ctaLoading: busy, ctaLoadingLabel: strings.verify.ctaLoadingLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: _jsx(PrizmaTextField, { className: 
+        ctaLoading: busy, ctaDisabled: emptyError, ctaLoadingLabel: strings.verify.ctaLoadingLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: _jsx(PrizmaTextField, { className: 
             /* Core's OWN static-focus modifier — the class its CSS already
                implements beside `:focus-within`. `PrizmaTextField` has no
                `forceState` prop the way `PrizmaDropdown` does, so this is how a
                static spec state draws the focus ring without redeclaring any
                styling (DEVIATIONS #PI-7). */
-            focused ? 'prizma-input-textfield--focused' : undefined, type: "email", inputMode: "email", autoComplete: "email", "aria-label": strings.verify.fieldLabel, placeholder: strings.verify.placeholder, 
+            focused ? 'prizma-input-textfield--focused' : undefined, type: "email", inputMode: "email", autoComplete: "email", "aria-label": strings.verify.fieldLabel, placeholder: emptyError ? undefined : strings.verify.placeholder, 
             /* Uncontrolled: a screen is one static spec state, so no `onChange`
                is needed and no warning is raised. */
-            defaultValue: value ?? '', disabled: busy, error: invalid, errorText: invalid ? strings.verify.errorText : undefined, 
+            defaultValue: emptyError ? '' : value ?? '', disabled: busy, error: invalid || emptyError, errorText: invalid
+                ? strings.verify.errorText
+                : emptyError
+                    ? strings.requiredError
+                    : undefined, 
             /* The clear ✕ is drawn on the `error` section only. */
             clearable: invalid, clearLabel: strings.verify.clearLabel }) }));
 });

package/dist/FaceMatchComparisonScreen.d.ts

@@ -8,9 +8,9 @@ import './FaceMatchLayout.css';
  *  contract as `camera` on the capture screens) — Face Match never captures. */
 export type FaceMatchPhotoRole = 'selfie' | 'id' | 'nfc' | 'secondId';
 /** Host-supplied portraits, one per role the chosen variant asks for. A role
- *  left out renders the empty state: a Brand/50 disc, marked with
- *  `.face-match-cluster__photo--empty`. Interim treatment (2026-09-25) while
- *  the designed no-photo state is drawn; see FaceMatchLayout.css. */
+ *  left out renders the empty state (capture missing or not retrievable): a
+ *  grey Surface/Neutral/100 disc under its usual label tooltip, marked with
+ *  `.face-match-cluster__photo--empty`. See FaceMatchLayout.css. */
 export type FaceMatchComparisonPhotos = Partial<Record<FaceMatchPhotoRole, ReactNode>>;
 /**
  * Where the comparison is in its own choreography — the module MOVING rather

package/dist/FaceMatchLayout.css

@@ -57,8 +57,14 @@
 
   /* The disc's diameter, named once. `--matching`'s rosette and `--animated`'s
    * convergence both have to know it, and a second literal is a second thing to
-   * forget. Still a design literal, still DEVIATIONS #FM-22 — just not repeated. */
-  --face-match-photo: 160px;
+   * forget. Still a design literal, still DEVIATIONS #FM-22 — just not repeated.
+   *
+   * 160 at most, and smaller when two discs and their gap do not fit the
+   * content column: on a 320 phone the column is 272, so each disc takes
+   * (272 − 16) / 2 = 128 (Camila, 2026-09-28). `100cqi` is the screen shell's
+   * width (ScreenShell.css, `container-type: size`), less its two Spacing/24
+   * gutters. At 390 and up this resolves to 160, unchanged. */
+  --face-match-photo: min(160px, calc((100cqi - 2 * var(--prizma-spacing-24) - var(--prizma-spacing-16)) / 2));
   /* Half the distance between two neighbouring discs: what one of them has to
    * travel to reach the pair's centre line. */
   --face-match-half-step: calc((var(--face-match-photo, 160px) + var(--prizma-spacing-16)) / 2);
@@ -118,16 +124,16 @@
   background: var(--prizma-surface-neutral-100);
 }
 
-/* No photo supplied for this role.
+/* No photo for this role: the capture was never taken, or could not be
+ * retrieved.
  *
- * INTERIM (2026-09-25, owner call): colour is the whole state for now, so the
- * slot reads as a portrait that belongs here rather than an undesigned hole.
- * Brand/50 is the same disc PrizmaIllustrationAvatar sits on, which is where
- * the designed state is most likely to land. The real treatment (bust,
- * outline, or copy) replaces this rule; the modifier and its class name stay,
- * so swapping it in is a one-rule change and nothing downstream moves. */
+ * Owner call 2026-09-28 (replaces the 2026-09-25 Brand/50 interim): a plain
+ * grey disc, Surface/Neutral/100, the same neutral Core puts behind an image
+ * that is not there yet (CaptureDigitalId.css, list.css). The callout above it
+ * still renders, so the tooltip names which capture is missing. The modifier
+ * stays a named state so a richer treatment is still a one-rule change. */
 .face-match-cluster__photo--empty {
-  background: var(--prizma-surface-brand-50);
+  background: var(--prizma-surface-neutral-100);
 }
 
 .face-match-cluster__photo > img,
@@ -153,11 +159,14 @@
 }
 
 .face-match-cluster--matching .face-match-cluster__face + .face-match-cluster__face {
-  margin-left: -44px; /* hardcoded — Figma converged overlap; no token (verified absent) */
+  /* Figma converged overlap, 44 on the 160 disc; no token (verified absent).
+   * Kept as that ratio so the rosette holds its shape on a smaller disc. */
+  margin-left: calc(var(--face-match-photo, 160px) * -44 / 160);
 }
 
 .face-match-cluster--matching .face-match-cluster__row + .face-match-cluster__row {
-  margin-top: calc(-2 * var(--prizma-spacing-40));
+  /* Half a disc: 80 on the 160 disc (`2 × Spacing/40`), proportional below it. */
+  margin-top: calc(var(--face-match-photo, 160px) / -2);
 }
 
 /* ── The comparison, moving (`phase` on FaceMatchComparisonScreen) ───────────

package/dist/FormScreen.css

@@ -129,6 +129,22 @@
     flex: none;
     width: calc(50% - var(--prizma-spacing-16) / 2);
     min-width: 0;
+    position: relative;
+  }
+  /* An error or helper line under ONE field of a pair made that field taller,
+   * and the bottom alignment above lifted its input above its neighbour's
+   * (Elena, 2026-10-02: "estos inputs tienen que estar alineados"). The line
+   * hangs below its input instead, out of the alignment, and the row reserves
+   * its height so the next row does not ride over it. */
+  .prizma-form-screen--responsive .prizma-form-screen__row > * > [class$="__error"],
+  .prizma-form-screen--responsive .prizma-form-screen__row > * > [class$="__helper"] {
+    position: absolute;
+    top: 100%;
+    left: 0;
+    margin-top: var(--prizma-spacing-8);
+  }
+  .prizma-form-screen--responsive .prizma-form-screen__row:has(> * > [class$="__error"], > * > [class$="__helper"]) {
+    padding-bottom: calc(var(--prizma-spacing-8) + var(--prizma-body-m-regular-line-height));
   }
 
   /* Continue and Back share a row: Back on the left, Continue on the right, as

package/dist/FormsLongFormScreen.d.ts

@@ -65,6 +65,14 @@ export interface FormsLongFormScreenProps extends Omit<PrizmaFormScreenProps, 't
  * into the CTA band — the half a module stylesheet kept losing. It is a no-op
  * on the short `name` preset, whose rows never overflow. DEVIATIONS #DSC-2,
  * restating #CURP-1.
+ *
+ * `emptyError` is the GUIDELINES §6-E empty-submit rule (Elena 2026-09-30):
+ * the user pressed the CTA with the form still empty. Every REQUIRED row
+ * renders empty, with no placeholder, in Core's own error state carrying
+ * `strings.requiredError`; optional and unmarked rows stay on their resting
+ * surface with no error. The CTA greys there and ONLY there: the resting
+ * `default` keeps it enabled, so the user can press it to reach the error —
+ * the `FormsFieldScreen` `emptyError` precedent applied to a stack.
  */
 export declare const FormsLongFormScreen: React.ForwardRefExoticComponent<FormsLongFormScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default FormsLongFormScreen;