@incodetech/prizma-core-screens 0.2.3 → 0.2.7

package/dist/CurpEnterScreen.d.ts

@@ -46,6 +46,13 @@ export interface CurpEnterScreenProps extends Omit<PrizmaFormScreenProps, 'title
  * `linkContent` slot: no primitive is invented, no layout is declared, and the
  * two actions stay distinguishable (`cta` vs `secondary`, the #PI-10 rule).
  * The gap is reported for promotion — see the module's DEVIATIONS rows.
+ *
+ * `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 CurpEnterScreen: React.ForwardRefExoticComponent<CurpEnterScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default CurpEnterScreen;

package/dist/CurpEnterScreen.js

@@ -37,6 +37,13 @@ import './CurpLayout.css';
  * `linkContent` slot: no primitive is invented, no layout is declared, and the
  * two actions stay distinguishable (`cta` vs `secondary`, the #PI-10 rule).
  * The gap is reported for promotion — see the module's DEVIATIONS rows.
+ *
+ * `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 CurpEnterScreen = forwardRef(({ strings, state = 'default', value, screenId = `curp-enter-${state}`, className, overrides, onAction, ...shell }, ref) => {
     // Figma treats the five sections as four distinct field treatments:
@@ -47,6 +54,9 @@ export const CurpEnterScreen = forwardRef(({ strings, state = 'default', value,
     // surface.
     const busy = state === 'loading';
     const invalid = state === 'error';
+    // Empty submit: the field stays empty, drops its placeholder and takes
+    // Core's error state with the shared "required" row; the CTA greys.
+    const emptyError = state === 'emptyError';
     const focused = state === 'focused' || state === 'filled';
     return (_jsx(PrizmaFormScreen, { ref: ref, 
         /* Scopes the one module rule that lets the `error` section keep the
@@ -63,11 +73,15 @@ export const CurpEnterScreen = forwardRef(({ strings, state = 'default', value,
             .filter(Boolean)
             .join(' '), title: strings.enter.title, subtitle: strings.enter.subtitle, ctaLabel: strings.enter.ctaLabel, 
         /* The `loading` section swaps the CTA label for Core's spinner. */
-        ctaLoading: busy, ctaLoadingLabel: strings.enter.ctaLoadingLabel, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", 
+        ctaLoading: busy, ctaDisabled: emptyError, ctaLoadingLabel: strings.enter.ctaLoadingLabel, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", 
             /* Figma greys this action too while the lookup runs. */
-            disabled: busy, onClick: () => onAction?.({ type: 'secondary', screenId }), children: strings.enter.noCurpLabel }), verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: _jsx(PrizmaTextField, { className: focused ? 'prizma-input-textfield--focused' : undefined, "aria-label": strings.enter.fieldLabel, placeholder: strings.enter.placeholder, defaultValue: value ?? '', 
+            disabled: busy, onClick: () => onAction?.({ type: 'secondary', screenId }), children: strings.enter.noCurpLabel }), verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: _jsx(PrizmaTextField, { className: focused ? 'prizma-input-textfield--focused' : undefined, "aria-label": strings.enter.fieldLabel, placeholder: emptyError ? undefined : strings.enter.placeholder, defaultValue: emptyError ? '' : value ?? '', 
             /* A CURP is an 18-character uppercase key. */
-            autoCapitalize: "characters", autoComplete: "off", spellCheck: false, disabled: busy, error: invalid, errorText: invalid ? strings.enter.errorText : undefined, 
+            autoCapitalize: "characters", autoComplete: "off", spellCheck: false, disabled: busy, error: invalid || emptyError, errorText: invalid
+                ? strings.enter.errorText
+                : emptyError
+                    ? strings.requiredError
+                    : undefined, 
             /* The clear ✕ is drawn only on the error section (76:36434); the
                `filled` section (79:1553) draws none. Core still owns WHEN it
                shows — its `--show` state needs a value in the field. */

package/dist/CurpGenerateScreen.d.ts

@@ -42,6 +42,14 @@ export interface CurpGenerateScreenProps extends Omit<PrizmaFormScreenProps, 'ti
  * The `dropdown` section IS the open-menu spec state, which Core exposes as the
  * documentation-only `forceOpen` (a screen is one static state, never a live
  * interaction) — the same mechanism Phone Input's `countryCode` section uses.
+ *
+ * `emptyError` is the empty-submit state (rule from Elena, 2026-09-30,
+ * GUIDELINES §6-E empty-submit rule): "Generate" was pressed with the form
+ * empty. All six fields carry the required `*`, so all six render empty with no
+ * placeholder, in Core's error state with `requiredError`; no menu is open 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 CurpGenerateScreen: React.ForwardRefExoticComponent<CurpGenerateScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default CurpGenerateScreen;

package/dist/CurpGenerateScreen.js

@@ -29,29 +29,44 @@ import './CurpLayout.css';
  * The `dropdown` section IS the open-menu spec state, which Core exposes as the
  * documentation-only `forceOpen` (a screen is one static state, never a live
  * interaction) — the same mechanism Phone Input's `countryCode` section uses.
+ *
+ * `emptyError` is the empty-submit state (rule from Elena, 2026-09-30,
+ * GUIDELINES §6-E empty-submit rule): "Generate" was pressed with the form
+ * empty. All six fields carry the required `*`, so all six render empty with no
+ * placeholder, in Core's error state with `requiredError`; no menu is open 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 CurpGenerateScreen = forwardRef(({ strings, state = 'default', values, genders = [], states = [], screenId = `curp-generate-${state}`, className, overrides, onAction, ...shell }, ref) => {
     const copy = strings.generate;
+    // Empty submit: every required field drops its value and placeholder and
+    // takes Core's error state with the shared "required" row; the CTA greys.
+    const emptyError = state === 'emptyError';
+    const ph = (placeholder) => (emptyError ? undefined : placeholder);
+    const err = {
+        error: emptyError,
+        errorText: emptyError ? strings.requiredError : undefined,
+    };
     return (_jsxs(PrizmaFormScreen, { ref: ref, 
-        /* Scopes the two module rules in CurpLayout.css (see the foundation and
-           Core requests recorded there):
-           - `--scroll` lets the six-field stack scroll inside the 844 frame
-             instead of overflowing its box and painting over the CTA. EVERY
-             section gets it, `dropdown` included — Figma draws "Generate"
-             clear and unobstructed under the open menu.
-           - `--menu-open` flips Core's absolutely-positioned menu above its
-             trigger on the one section that forces it open, so the three
-             gender rows stay inside the scrolling column. */
-        className: [
+        /* The six-field stack scrolls inside the 844 frame through the
+           foundation's `scrollFields` (overflow + the Spacing/16 that keeps the
+           cut clear of "Generate"). EVERY section gets it, `dropdown` included:
+           Figma draws "Generate" clear and unobstructed under the open menu.
+           It replaces the module's old `--scroll` rule, which scrolled but
+           carried no spacing, so the last field ran flush into the button.
+           `--menu-open` (CurpLayout.css) flips Core's absolutely-positioned
+           menu above its trigger on the one section that forces it open, so
+           the three gender rows stay inside the scrolling column. */
+        scrollFields: true, className: [
             'curp-generate',
-            'curp-generate--scroll',
             state === 'dropdown' ? 'curp-generate--menu-open' : '',
             className,
         ]
             .filter(Boolean)
-            .join(' '), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, ctaLoadingLabel: copy.ctaLoadingLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: [_jsx(PrizmaTextField, { label: copy.firstName.label, placeholder: copy.firstName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.firstName ?? '' }), _jsx(PrizmaTextField, { label: copy.firstLastName.label, placeholder: copy.firstLastName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.firstLastName ?? '' }), _jsx(PrizmaTextField, { label: copy.secondLastName.label, placeholder: copy.secondLastName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.secondLastName ?? '' }), _jsx(PrizmaDropdown, { label: copy.gender.label, placeholder: copy.gender.placeholder, required: true, requiredHint: strings.requiredHint, options: genders, defaultValue: values?.gender ?? null, searchPlaceholder: copy.gender.searchPlaceholder, 
+            .join(' '), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, ctaDisabled: emptyError, ctaLoadingLabel: copy.ctaLoadingLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: [_jsx(PrizmaTextField, { label: copy.firstName.label, placeholder: ph(copy.firstName.placeholder), required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: emptyError ? '' : values?.firstName ?? '', ...err }), _jsx(PrizmaTextField, { label: copy.firstLastName.label, placeholder: ph(copy.firstLastName.placeholder), required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: emptyError ? '' : values?.firstLastName ?? '', ...err }), _jsx(PrizmaTextField, { label: copy.secondLastName.label, placeholder: ph(copy.secondLastName.placeholder), required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: emptyError ? '' : values?.secondLastName ?? '', ...err }), _jsx(PrizmaDropdown, { label: copy.gender.label, placeholder: ph(copy.gender.placeholder), required: true, requiredHint: strings.requiredHint, options: genders, defaultValue: emptyError ? null : values?.gender ?? null, ...err, searchPlaceholder: copy.gender.searchPlaceholder, 
                 /* The `dropdown` section is the open Gender menu. */
-                forceOpen: state === 'dropdown' }), _jsx(PrizmaDateField, { label: copy.dateOfBirth.label, placeholder: copy.dateOfBirth.placeholder, required: true, requiredHint: strings.requiredHint, calendarLabel: copy.dateOfBirth.calendarLabel, defaultValue: values?.dateOfBirth ?? '' }), _jsx(PrizmaDropdown, { label: copy.birthState.label, placeholder: copy.birthState.placeholder, required: true, requiredHint: strings.requiredHint, options: states, defaultValue: values?.birthState ?? null, searchable: true, searchPlaceholder: copy.birthState.searchPlaceholder })] }));
+                forceOpen: state === 'dropdown' }), _jsx(PrizmaDateField, { label: copy.dateOfBirth.label, placeholder: ph(copy.dateOfBirth.placeholder), required: true, requiredHint: strings.requiredHint, calendarLabel: copy.dateOfBirth.calendarLabel, defaultValue: emptyError ? '' : values?.dateOfBirth ?? '', ...err }), _jsx(PrizmaDropdown, { label: copy.birthState.label, placeholder: ph(copy.birthState.placeholder), required: true, requiredHint: strings.requiredHint, options: states, defaultValue: emptyError ? null : values?.birthState ?? null, ...err, searchable: true, searchPlaceholder: copy.birthState.searchPlaceholder })] }));
 });
 CurpGenerateScreen.displayName = 'CurpGenerateScreen';
 export default CurpGenerateScreen;

package/dist/CurpLayout.css

@@ -1,6 +1,6 @@
 /* CURP — module layout additions.
  *
- * THREE rules, and none of them declares spacing: the content column, the 24px
+ * TWO rules, and none of them declares spacing: the content column, the 24px
  * gutters, the title → fields Spacing/32, the field gaps, the CTA column and
  * the anchored footer all stay the foundation's (`ScreenLayout.css`,
  * `FormScreen.css`). Nothing here re-declares an archetype value, invents a
@@ -10,40 +10,14 @@
  */
 
 /* ── The generator's field stack is taller than the screen ───────────────────
- * `CURP.Gene.default` is a 1051-tall frame: its `input-list` alone is 548 tall
- * (six 78px labelled fields at Spacing/16) and the CONTENT frame grows to 861
- * instead of the usual 654. At the 390×844 reference the column has ~470 for
- * it, so the last dropdown and the CTA fall past the fold.
- *
- * Archetype E's `.prizma-form-screen__fields` is `flex: 1; min-height: 0` with
- * no overflow behaviour — it was measured against Phone Input, whose forms are
- * one or two fields — so the surplus is silently clipped by `ScreenShell`'s
- * `overflow: hidden`, and (because the fields cannot shrink below
- * `--prizma-input-size-field-height`) it first PAINTS OVER the sibling CTA.
- * Screens are authored at 390×844 and never reflow (README / DEVIATIONS #17),
- * so growing the frame is not an option either.
- *
- * The stack is therefore allowed to scroll INSIDE the column: the title, the
- * CTA and the anchored tag stay put and the six fields pan, which is the
- * closest a fixed 844 frame gets to Figma's taller page. It adds NO padding, NO
- * gap and NO size of its own.
- *
- * Applied to EVERY `CURP.Gene.*` section including `dropdown`. The earlier
- * build withheld it from `dropdown` to keep Core's absolutely-positioned menu
- * from being clipped, and that traded one clipped element for a worse one: with
- * `overflow: visible` the 548-tall stack overflowed its box and painted the
- * open menu straight across the "Generate" button, which Figma (2058:16373)
- * draws clear and unobstructed under the menu. The CTA is never allowed to be
- * overlapped; the menu is handled by the next rule instead.
- *
- * FOUNDATION REQUEST: promote this to `FormScreen.css` as a
- * `.prizma-form-screen__fields--scroll` variant (or make overflow the default),
- * driven by a `scrollFields` prop on `PrizmaFormScreen`. Every long-form module
- * still to come in Wave 3 — eKYC, eKYB, address entry — will hit the same wall.
+ * `CURP.Gene.default` is a 1051-tall frame (six 78px labelled fields at
+ * Spacing/16), so at 390×844 the stack scrolls inside the column. That is the
+ * foundation's `scrollFields` on `PrizmaFormScreen` now (FormScreen.css
+ * `__fields--scroll`), which also carries the Spacing/16 between the cut and
+ * the CTA. The module used to hand-roll `overflow-y: auto` here with no
+ * spacing, so the last field ran flush into "Generate" (Elena, 2026-09-30).
+ * Removed in favour of the foundation rule.
  */
-.curp-generate--scroll .prizma-form-screen__fields {
-  overflow-y: auto;
-}
 
 /* ── The open Gender menu must stay inside the scrolling column ──────────────
  * `CURP.Gene.dropdown` exists to show the three gender rows, so they may not be

package/dist/CurpStrings.d.ts

@@ -11,15 +11,23 @@
  * - `error`   — negative field + clear ✕ + the "Invalid CURP" row
  * - `loading` — both actions inert while the lookup runs; the spinner rides the
  *   CTA, never the field (the Phone Input lesson, DEVIATIONS #PI-5)
+ * - `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 CurpEnterState = 'default' | 'focused' | 'filled' | 'error' | 'loading';
+export type CurpEnterState = 'default' | 'focused' | 'filled' | 'error' | 'loading' | 'emptyError';
 /**
  * The `CURP.Gene.*` form sections — the six-field generator:
  * - `default`  — every field empty on its placeholder
  * - `dropdown` — the Gender menu open over the form (Core's `forceOpen`)
  * - `filled`   — every field carrying a value
+ * - `emptyError` — "Generate" pressed with the form still empty: every required
+ *   field stays empty (no placeholder) in Core's error state with
+ *   `requiredError`, no menu is open, and the CTA is disabled. GUIDELINES §6-E
+ *   empty-submit rule (Elena, 2026-09-30).
  */
-export type CurpGenerateState = 'default' | 'dropdown' | 'filled';
+export type CurpGenerateState = 'default' | 'dropdown' | 'filled' | 'emptyError';
 /**
  * The two spinner sections. `verifying` is `CURP.EnterCURP.veryfing` (the
  * Figma layer name carries the typo); `generating` is `CURP.Gene.generating`.
@@ -73,6 +81,12 @@ export interface CurpStrings {
      * the marker is localizable and never hardcoded in a screen.
      */
     requiredHint?: string;
+    /**
+     * Error row under every required field left empty when the primary CTA is
+     * pressed (the `emptyError` state of the entry and generator forms):
+     * "This field is required". SDK key `dynamicForms.fieldRequired`.
+     */
+    requiredError: string;
     /** CURP.EnterCURP.{default,focused,filled,error,loading} */
     enter: {
         /** H2 ("Enter your CURP"). */

package/dist/EkybAddressDetailsScreen.d.ts

@@ -56,6 +56,13 @@ export interface EkybAddressDetailsScreenProps extends Omit<PrizmaFormScreenProp
  * segment 2 solid, segment 3 grey) is Core's `PrizmaStepper` at
  * `currentState={2}`, composed into the archetype's `progress` slot. This is
  * step 2 of 3.
+ *
+ * `emptyError` is Continue 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 five REQUIRED ones (State
+ * included) in Core's `error` state with `requiredError` and no placeholder,
+ * Address line 2 unflagged (optional, DEVIATIONS #EKC-6's rule), and Continue
+ * disabled. `empty` keeps Continue enabled so the press can happen.
  */
 export declare const EkybAddressDetailsScreen: React.ForwardRefExoticComponent<EkybAddressDetailsScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default EkybAddressDetailsScreen;

package/dist/EkybAddressDetailsScreen.js

@@ -46,22 +46,40 @@ import './ScreenLayout.css';
  * segment 2 solid, segment 3 grey) is Core's `PrizmaStepper` at
  * `currentState={2}`, composed into the archetype's `progress` slot. This is
  * step 2 of 3.
+ *
+ * `emptyError` is Continue 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 five REQUIRED ones (State
+ * included) in Core's `error` state with `requiredError` and no placeholder,
+ * Address line 2 unflagged (optional, DEVIATIONS #EKC-6's rule), and Continue
+ * disabled. `empty` keeps Continue enabled so the press can happen.
  */
-export const EkybAddressDetailsScreen = forwardRef(({ strings, state = 'empty', values, states = [], screenId = `ekyb-address-${state}`, className, overrides, onAction, ...shell }, ref) => {
+export const EkybAddressDetailsScreen = forwardRef(({ strings, state = 'empty', values: valuesProp, states = [], screenId = `ekyb-address-${state}`, ctaDisabled, className, overrides, onAction, ...shell }, ref) => {
     const copy = strings.address;
+    const emptyError = state === 'emptyError';
+    const values = emptyError ? undefined : valuesProp;
+    // Core's own error treatment, spread AFTER each required field's own
+    // placeholder so the error state shows none (the `FormsFieldScreen`
+    // precedent). Address line 2 never receives it.
+    const missing = emptyError
+        ? { error: true, errorText: strings.requiredError, placeholder: undefined }
+        : {};
     return (_jsxs(PrizmaFormScreen, { ref: ref, className: ['ekyb-address', className].filter(Boolean).join(' '), 
         /* The archetype's own scrolling field stack — the six-field column is
            548 tall against a middle that cannot be. No module CSS. */
         scrollFields: true, 
         /* Step 2 of 3. `showIcons={false}`: the eKYB bar is a bare 5px rail. */
-        progress: _jsx(PrizmaStepper, { steps: 3, currentState: 2, showIcons: false, "aria-label": strings.stepperLabel }), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", 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: on a wide frame only State + Postal code
-           share a row (Figma 6407:43637); the four text fields above span the
-           column. On the phone nothing changes. */
-        responsive: true, ...shell, children: [_jsx(PrizmaTextField, { label: copy.street.label, placeholder: copy.street.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.street ?? '' }), _jsx(PrizmaTextField, { label: copy.houseNumber.label, placeholder: copy.houseNumber.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.houseNumber ?? '' }), _jsx(PrizmaTextField, { label: copy.addressLine2.label, placeholder: copy.addressLine2.placeholder, autoComplete: "off", defaultValue: values?.addressLine2 ?? '' }), _jsx(PrizmaTextField, { label: copy.city.label, placeholder: copy.city.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.city ?? '' }), _jsxs(PrizmaFormRow, { children: [_jsx(PrizmaDropdown, { label: copy.state.label, placeholder: copy.state.placeholder, required: true, requiredHint: strings.requiredHint, options: states, 
+        progress: _jsx(PrizmaStepper, { steps: 3, currentState: 2, showIcons: false, "aria-label": strings.stepperLabel }), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, 
+        /* Disabled only after the empty submit; `empty` keeps it enabled. */
+        ctaDisabled: emptyError || ctaDisabled, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", 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: on a wide frame the fields pair up in
+           three rows, Street + House number, Address line 2 + City (Elena,
+           2026-09-28), and State + Postal code (Figma 6407:43637). On the
+           phone nothing changes. */
+        responsive: true, ...shell, children: [_jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.street.label, placeholder: copy.street.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.street ?? '' }), _jsx(PrizmaTextField, { label: copy.houseNumber.label, placeholder: copy.houseNumber.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.houseNumber ?? '' })] }), _jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.addressLine2.label, placeholder: copy.addressLine2.placeholder, autoComplete: "off", defaultValue: values?.addressLine2 ?? '' }), _jsx(PrizmaTextField, { label: copy.city.label, placeholder: copy.city.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.city ?? '' })] }), _jsxs(PrizmaFormRow, { children: [_jsx(PrizmaDropdown, { label: copy.state.label, placeholder: copy.state.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, options: states, 
                         /* Both sections draw the placeholder unless the host supplies a
                            value — see the docstring note on 6340:38197. */
-                        defaultValue: values?.state ?? null }), _jsx(PrizmaTextField, { label: copy.postalCode.label, placeholder: copy.postalCode.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.postalCode ?? '' })] })] }));
+                        defaultValue: values?.state ?? null }), _jsx(PrizmaTextField, { label: copy.postalCode.label, placeholder: copy.postalCode.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.postalCode ?? '' })] })] }));
 });
 EkybAddressDetailsScreen.displayName = 'EkybAddressDetailsScreen';
 export default EkybAddressDetailsScreen;

package/dist/EkybBusinessDetailsScreen.d.ts

@@ -50,6 +50,12 @@ export interface EkybBusinessDetailsScreenProps extends Omit<PrizmaFormScreenPro
  * bar is at `currentState="Start"`: segment 1 filled, segments 2 and 3 grey,
  * exactly what 5919:68599 renders. Both offsets around it live in
  * `ScreenLayout.css`, never here.
+ *
+ * `emptyError` is Continue pressed with the fields still empty (Elena,
+ * 2026-09-30, GUIDELINES §6-E empty-submit rule; precedent `FormsFieldScreen`'s
+ * `emptyError`): both REQUIRED fields render empty in Core's `error` state with
+ * `requiredError` under them, and Continue is disabled. `empty` keeps Continue
+ * enabled so the press can happen.
  */
 export declare const EkybBusinessDetailsScreen: React.ForwardRefExoticComponent<EkybBusinessDetailsScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default EkybBusinessDetailsScreen;

package/dist/EkybBusinessDetailsScreen.js

@@ -4,7 +4,7 @@ import { forwardRef } from 'react';
 import { PrizmaTextField } from '@incodetech/prizma-core-web/text-field';
 import { PrizmaButton } from '@incodetech/prizma-core-web/button';
 import { PrizmaStepper } from '@incodetech/prizma-core-web/stepper';
-import { PrizmaFormScreen, PrizmaFormRow } from './FormScreen';
+import { PrizmaFormScreen } from './FormScreen';
 import './ScreenLayout.css';
 /**
  * eKYB — step 1 of the wizard, the company's identity, built on the Form
@@ -42,19 +42,36 @@ import './ScreenLayout.css';
  * bar is at `currentState="Start"`: segment 1 filled, segments 2 and 3 grey,
  * exactly what 5919:68599 renders. Both offsets around it live in
  * `ScreenLayout.css`, never here.
+ *
+ * `emptyError` is Continue pressed with the fields still empty (Elena,
+ * 2026-09-30, GUIDELINES §6-E empty-submit rule; precedent `FormsFieldScreen`'s
+ * `emptyError`): both REQUIRED fields render empty in Core's `error` state with
+ * `requiredError` under them, and Continue is disabled. `empty` keeps Continue
+ * enabled so the press can happen.
  */
-export const EkybBusinessDetailsScreen = forwardRef(({ strings, state = 'empty', values, screenId = `ekyb-business-${state}`, overrides, onAction, ...shell }, ref) => {
+export const EkybBusinessDetailsScreen = forwardRef(({ strings, state = 'empty', values: valuesProp, screenId = `ekyb-business-${state}`, ctaDisabled, overrides, onAction, ...shell }, ref) => {
     const copy = strings.business;
-    return (_jsx(PrizmaFormScreen, { ref: ref, 
+    const emptyError = state === 'emptyError';
+    const values = emptyError ? undefined : valuesProp;
+    // Core's own error treatment, spread onto the REQUIRED fields only; the
+    // error state shows no placeholder (the `FormsFieldScreen` precedent).
+    const missing = emptyError
+        ? { error: true, errorText: strings.requiredError, placeholder: undefined }
+        : {};
+    return (_jsxs(PrizmaFormScreen, { ref: ref, 
         /* Step 1 of 3. `showIcons={false}` because the eKYB frames draw the bar
            as a bare 5px rail with no glyph row. */
-        progress: _jsx(PrizmaStepper, { steps: 3, currentState: "Start", showIcons: false, "aria-label": strings.stepperLabel }), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", onClick: () => onAction?.({ type: 'secondary', screenId }), children: strings.backLabel }), verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, 
+        progress: _jsx(PrizmaStepper, { steps: 3, currentState: "Start", showIcons: false, "aria-label": strings.stepperLabel }), title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, 
+        /* Disabled only after the empty submit; `empty` keeps it enabled. */
+        ctaDisabled: emptyError || ctaDisabled, linkContent: _jsx(PrizmaButton, { variant: "secondary", size: "L", onClick: () => onAction?.({ type: 'secondary', screenId }), children: strings.backLabel }), verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, 
         /* Left-aligned title block, the alignment every eKYB frame draws; a host
            `align` still wins (#GEO-2). */
         overrides: { align: overrides?.align ?? 'left', logo: overrides?.logo }, onAction: onAction, 
         /* Exploration ekyb-desktop: on a tablet or desktop frame the two
-           fields share a row; on the phone nothing changes. */
-        responsive: true, ...shell, children: _jsxs(PrizmaFormRow, { children: [_jsx(PrizmaTextField, { label: copy.businessName.label, placeholder: copy.businessName.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.businessName ?? '' }), _jsx(PrizmaTextField, { label: copy.taxId.label, placeholder: copy.taxId.placeholder, required: true, requiredHint: strings.requiredHint, autoComplete: "off", defaultValue: values?.taxId ?? '' })] }) }));
+           fields stay on two rows, each spanning the column (Elena,
+           2026-09-28); `responsive` still pairs Continue and Back. On the
+           phone nothing changes. */
+        responsive: true, ...shell, children: [_jsx(PrizmaTextField, { label: copy.businessName.label, placeholder: copy.businessName.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.businessName ?? '' }), _jsx(PrizmaTextField, { label: copy.taxId.label, placeholder: copy.taxId.placeholder, required: true, requiredHint: strings.requiredHint, ...missing, autoComplete: "off", defaultValue: values?.taxId ?? '' })] }));
 });
 EkybBusinessDetailsScreen.displayName = 'EkybBusinessDetailsScreen';
 export default EkybBusinessDetailsScreen;

package/dist/EkybCountryScreen.d.ts

@@ -39,14 +39,22 @@ export interface EkybCountryScreenProps extends Omit<PrizmaFormScreenProps, 'tit
  *    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 "🇺🇸 United States": flag
+ *    and country name, 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 travels
+ *    inside the label text because Core still ships no country-flag primitive
+ *    (#PI-3).
  *
  * 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 declare const EkybCountryScreen: React.ForwardRefExoticComponent<EkybCountryScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default EkybCountryScreen;

package/dist/EkybCountryScreen.js

@@ -26,26 +26,44 @@ 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 "🇺🇸 United States": flag
+ *    and country name, 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 travels
+ *    inside the label text because Core still ships no country-flag primitive
+ *    (#PI-3).
  *
  * 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

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. */