@incodetech/prizma-core-screens 0.2.4 → 0.2.12

package/dist/EkybCountryScreen.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef } from 'react';
 import { PrizmaDropdown } from '@incodetech/prizma-core-web/dropdown';
+import { PrizmaCountryFlag } from '@incodetech/prizma-core-web/combined';
 import { PrizmaFormScreen } from './FormScreen';
 import './ScreenLayout.css';
 /**
@@ -26,33 +27,63 @@ import './ScreenLayout.css';
  *    live interaction) — the same mechanism Phone Input's `countryCode` and
  *    CURP's `Gene.dropdown` sections use. The search bar Figma draws inside the
  *    menu is Core's own `searchable`.
- * 3. The closed field and the menu row are DIFFERENT faces of one option:
- *    5707:54174 draws "🇺🇸 United States" in the field while the rows read
- *    "🇺🇸 +1 United States". That is Core's `PrizmaDropdownOption.fieldLabel`,
- *    so nothing is hand-composed. The flag travels inside the label text
- *    because Core still ships no country-flag primitive (#PI-3).
+ * 3. Menu rows and the closed field read the same flag + "United States",
+ *    no dial code. Figma 5707:54174 draws the rows with Phone Input's "+1"
+ *    prefixes, dropped by the owner (Elena, 2026-09-28) because a country of
+ *    registration has no phone prefix. The flag is Core's raster in the
+ *    dropdown's leading slot, not an emoji in the label (Elena, 2026-10-23;
+ *    #PI-3, the WatchlistBusinessFormScreen precedent).
  *
  * This page is the only eKYB form page with NO "Back" secondary and NO Stepper —
  * it is step 0, before the three-step wizard starts.
+ *
+ * `emptyError` is Continue pressed with no country chosen (Elena, 2026-09-30,
+ * GUIDELINES §6-E empty-submit rule; precedent `FormsFieldScreen`'s
+ * `emptyError`): the dropdown renders empty, with no placeholder, in Core's
+ * `error` state with `requiredError` under it, and Continue is disabled. The
+ * field draws no `*`, but it is the page's only input and the flow cannot go on
+ * without it, so it is treated as required. `empty` keeps Continue enabled.
  */
-export const EkybCountryScreen = forwardRef(({ strings, state = 'empty', countries = [], value, screenId = `ekyb-country-${state}`, overrides, onAction, ...shell }, ref) => {
+export const EkybCountryScreen = forwardRef(({ strings, state = 'empty', countries = [], value, screenId = `ekyb-country-${state}`, ctaDisabled, overrides, onAction, ...shell }, ref) => {
     const copy = strings.country;
     // `empty` is the only section drawn on the placeholder; both other sections
     // draw a chosen country in the closed field.
-    const selected = state === 'empty' ? null : (value ?? countries[0]?.value ?? null);
-    return (_jsx(PrizmaFormScreen, { ref: ref, title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, 
+    const emptyError = state === 'emptyError';
+    const selected = state === 'empty' || emptyError ? null : (value ?? countries[0]?.value ?? null);
+    return (_jsx(PrizmaFormScreen, { ref: ref, title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, 
+        /* Disabled only after the empty submit; `empty` keeps it enabled. */
+        ctaDisabled: emptyError || ctaDisabled, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, 
         /* Every eKYB 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 of
            its own, and a host that passes `align` still wins (#GEO-2). */
-        overrides: { align: overrides?.align ?? 'left', logo: overrides?.logo }, onAction: onAction, ...shell, children: _jsx(PrizmaDropdown, { label: copy.field.label, placeholder: copy.field.placeholder, options: countries, 
+        overrides: { align: overrides?.align ?? 'left', logo: overrides?.logo }, onAction: onAction, ...shell, children: _jsx(PrizmaDropdown, { label: copy.field.label, 
+            /* Required, but UNMARKED: a single-input screen shows no asterisk
+               and no legend (Core pattern "Optimistic submission", single-input
+               screens; Elena 2026-09-30). The requirement surfaces on submit,
+               through the empty-submit error. */
+            /* The error state draws the field with nothing in it, not even the
+               placeholder (the `FormsFieldScreen` precedent). */
+            placeholder: emptyError ? undefined : copy.field.placeholder, error: emptyError, errorText: emptyError ? strings.requiredError : undefined, options: countries, 
             /* Uncontrolled: a screen is one static spec state, so no `onChange` is
                needed. Core's `readOnly`/`disabled` are NOT used to freeze it —
                they paint the DISABLED grey surface on a section Figma draws white
                (DEVIATIONS #PI-6). */
             defaultValue: selected, searchable: true, searchPlaceholder: copy.searchPlaceholder, clearSearchLabel: copy.clearSearchLabel, 
             /* The `dropdown` section IS the open-menu spec state. */
-            forceOpen: state === 'dropdown' }) }));
+            forceOpen: state === 'dropdown', 
+            /* Core's canonical flag raster in the closed field and every menu
+               row (see note 3). A country outside the bank falls back to its
+               `flag` emoji. */
+            renderLeading: (option) => {
+                const match = countries.find((c) => c.value === option.value);
+                return match ? (_jsx(PrizmaCountryFlag, { country: {
+                        code: match.value,
+                        name: match.label,
+                        dialCode: '',
+                        flag: match.flag ?? '',
+                    } })) : null;
+            } }) }));
 });
 EkybCountryScreen.displayName = 'EkybCountryScreen';
 export default EkybCountryScreen;

package/dist/EkybOwnersScreen.d.ts

@@ -38,6 +38,14 @@ export interface EkybOwnersScreenProps extends Omit<PrizmaFormScreenProps, 'titl
  * - `loading`        5663:94390 — `directorFilled` with the submission in
  *   flight: every field, both "Add another" links and "Back" go inert, and the
  *   spinner rides the CTA, never a field (the Phone Input lesson, #PI-5)
+ * - `uboEmptyError` / `directorEmptyError` (no frame) — `uboEmpty` /
+ *   `directorEmpty` after Continue was pressed with the fields still empty
+ *   (Elena, 2026-09-30, GUIDELINES §6-E empty-submit rule; precedent
+ *   `FormsFieldScreen`'s `emptyError`): every field renders empty, the two
+ *   REQUIRED UBO fields in Core's `error` state with `requiredError` and no
+ *   placeholder, the optional Director fields unflagged, and Continue
+ *   disabled. The `*Empty` states keep Continue enabled so the press can
+ *   happen.
  *
  * Four things are deliberate:
  *

package/dist/EkybOwnersScreen.js

@@ -30,6 +30,14 @@ import './ScreenLayout.css';
  * - `loading`        5663:94390 — `directorFilled` with the submission in
  *   flight: every field, both "Add another" links and "Back" go inert, and the
  *   spinner rides the CTA, never a field (the Phone Input lesson, #PI-5)
+ * - `uboEmptyError` / `directorEmptyError` (no frame) — `uboEmpty` /
+ *   `directorEmpty` after Continue was pressed with the fields still empty
+ *   (Elena, 2026-09-30, GUIDELINES §6-E empty-submit rule; precedent
+ *   `FormsFieldScreen`'s `emptyError`): every field renders empty, the two
+ *   REQUIRED UBO fields in Core's `error` state with `requiredError` and no
+ *   placeholder, the optional Director fields unflagged, and Continue
+ *   disabled. The `*Empty` states keep Continue enabled so the press can
+ *   happen.
  *
  * Four things are deliberate:
  *
@@ -65,24 +73,39 @@ import './ScreenLayout.css';
  * distinguishes `loading` from `directorFilled` above the fold, so it is not
  * optional chrome.
  */
-export const EkybOwnersScreen = forwardRef(({ strings, state = 'uboEmpty', values, screenId = `ekyb-owners-${state}`, className, overrides, onAction, ...shell }, ref) => {
+export const EkybOwnersScreen = forwardRef(({ strings, state = 'uboEmpty', values: valuesProp, screenId = `ekyb-owners-${state}`, ctaDisabled, className, overrides, onAction, ...shell }, ref) => {
     const copy = strings.owners;
     const busy = state === 'loading';
     const secondUbo = state === 'uboAdded';
-    const showDirector = state === 'directorEmpty' || state === 'directorFilled' || secondUbo || busy;
+    const emptyError = state === 'uboEmptyError' || state === 'directorEmptyError';
+    const values = emptyError ? undefined : valuesProp;
+    const showDirector = state === 'directorEmpty' ||
+        state === 'directorFilled' ||
+        state === 'directorEmptyError' ||
+        secondUbo ||
+        busy;
+    // Core's own error treatment, spread AFTER each required UBO field's own
+    // placeholder so the error state shows none (the `FormsFieldScreen`
+    // precedent). The Director fields are optional and never receive it.
+    const missing = emptyError
+        ? { error: true, errorText: strings.requiredError, placeholder: undefined }
+        : {};
     return (_jsxs(PrizmaFormScreen, { ref: ref, className: ['ekyb-owners', className].filter(Boolean).join(' '), 
         /* The archetype's own scrolling field stack — two titled blocks, four
            fields and two links do not fit a 844 frame. No module CSS. */
         scrollFields: true, 
         /* Step 3 of 3, and GREEN across all three once the submission runs. */
         progress: _jsx(PrizmaStepper, { steps: 3, currentState: busy ? 'Completed' : 3, showIcons: false, "aria-label": strings.stepperLabel, completedValueText: strings.stepperCompletedLabel }), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, 
+        /* Disabled only after the empty submit; the `*Empty` states keep it
+           enabled. */
+        ctaDisabled: emptyError || ctaDisabled, 
         /* `loading` swaps the CTA label for Core's designed spinner. */
         ctaLoading: busy, ctaLoadingLabel: copy.ctaLoadingLabel, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", 
             /* 5663:94390 greys "Back" while the submission runs. */
             disabled: busy, onClick: () => onAction?.({ type: 'secondary', screenId }), children: strings.backLabel }), verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: { align: overrides?.align ?? 'left', logo: overrides?.logo }, onAction: onAction, 
         /* Exploration ekyb-desktop: name + surname share a row per block on a
            wide frame; on the phone nothing changes. */
-        responsive: true, ...shell, children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.uboName.label, placeholder: copy.uboName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.uboName ?? '', disabled: busy }), _jsx(PrizmaTextField, { label: copy.uboSurname.label, placeholder: copy.uboSurname.placeholder, autoComplete: "off", defaultValue: values?.uboSurname ?? '', disabled: busy })] }), secondUbo ? (_jsxs(_Fragment, { children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.uboName.label, placeholder: copy.uboName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.secondUboName ?? '' }), _jsx(PrizmaTextField, { label: copy.uboSurname.label, placeholder: copy.uboSurname.placeholder, autoComplete: "off", defaultValue: values?.secondUboSurname ?? '' })] }), copy.removeUboLabel ? (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", onClick: () => onAction?.({ type: 'tertiary', screenId: `${screenId}-remove-ubo` }), children: copy.removeUboLabel })) : null] })) : null, _jsx(PrizmaButton, { variant: "tertiary-link", size: "L", disabled: busy, 
+        responsive: true, ...shell, children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.uboName.label, placeholder: copy.uboName.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.uboName ?? '', disabled: busy }), _jsx(PrizmaTextField, { label: copy.uboSurname.label, placeholder: copy.uboSurname.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.uboSurname ?? '', disabled: busy })] }), secondUbo ? (_jsxs(_Fragment, { children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.uboName.label, placeholder: copy.uboName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.secondUboName ?? '' }), _jsx(PrizmaTextField, { label: copy.uboSurname.label, placeholder: copy.uboSurname.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.secondUboSurname ?? '' })] }), copy.removeUboLabel ? (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", onClick: () => onAction?.({ type: 'tertiary', screenId: `${screenId}-remove-ubo` }), children: copy.removeUboLabel })) : null] })) : null, _jsx(PrizmaButton, { variant: "tertiary-link", size: "L", disabled: busy, 
                 /* Action-qualified id: the two "Add another…" links are different
                    flows and must stay distinguishable (#PI-10), but the action
                    contract has no per-action discriminator yet. */

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,10 +58,14 @@ 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" after the
+     *  flag. */
     fieldLabel?: string;
+    /** Country menus only: the emoji fallback for a `value` outside Core's
+     *  flag raster bank. The country screen draws the bank's flag by `value`,
+     *  so this never travels inside `label`. */
+    flag?: string;
 }
 /** The values the business-identity page carries. Runtime data, never copy. */
 export interface EkybBusinessValues {
@@ -97,6 +112,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 +192,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 }) }));
 });