@incodetech/prizma-core-screens 0.2.4 → 0.2.7

package/dist/WatchlistBusinessFormScreen.js

@@ -11,8 +11,9 @@ import './ScreenLayout.css';
  * (GUIDELINES.md §6-E, `PrizmaFormScreen`).
  *
  * ONE screen for both purple form sections (`watchlist.default` and
- * `watchlist.filled`): measured against the 390 frames they share an identical
- * skeleton — nav → Title (H2, no subtitle) → Spacing/32 → Country dropdown,
+ * `watchlist.filled`), plus the `emptyError` state the GUIDELINES §6-E
+ * empty-submit rule adds (Elena 2026-09-30, see note 3): measured against the 390 frames they share an identical
+ * skeleton — nav → Title (H2 + the "fields marked with *" H5) → Spacing/32 → Country dropdown,
  * Business Name and Tax ID at Spacing/16 → primary CTA → tag — and differ ONLY
  * in field content and whether the CTA is live.
  *
@@ -27,11 +28,14 @@ import './ScreenLayout.css';
  *    and Core's `readOnly`, the other way to make a field inert, paints the
  *    DISABLED grey surface on states Figma draws white (DEVIATIONS #PI-6).
  *    Neither section greys anything, so `disabled` is set nowhere.
- * 3. The CTA state comes from the SECTION, not from the values: Figma greys
- *    "Continue" on `default` and lights it on `filled` — and `filled` leaves Tax
- *    ID empty, which is how we know the tax identifier does not gate the lookup
- *    (DEVIATIONS #WB-2). Deriving `ctaDisabled` from the values would have
- *    disagreed with the design.
+ * 3. The CTA state comes from the SECTION, not from the values. Under the
+ *    GUIDELINES §6-E empty-submit rule (Elena 2026-09-30) "Continue" is live
+ *    on the resting `default` form, so the user can press it, and greys ONLY
+ *    on `emptyError`, the state that press leads to: Country and Business
+ *    Name render empty (no placeholder) in Core's error state with
+ *    `requiredError`. Tax ID never errors — `filled` leaves it empty with the
+ *    CTA live, which is how we know it does not gate the lookup (DEVIATIONS
+ *    #WB-2).
  * 4. The country flag is Core's canonical raster (24×18, radius 2) in the
  *    dropdown's LEADING slot — `PrizmaCountryFlag` composed into
  *    `PrizmaDropdown.renderLeading`, which exists for exactly this case and
@@ -49,21 +53,29 @@ import './ScreenLayout.css';
  */
 export const WatchlistBusinessFormScreen = forwardRef(({ strings, state = 'default', countries = [], values, screenId = `watchlist-business-form-${state}`, overrides, onAction, ...shell }, ref) => {
     const copy = strings.form;
-    // `default` draws the CTA greyed, `filled` draws it live. The section is the
-    // spec, not the field contents (see note 3 above).
-    const empty = state === 'default';
+    // The CTA greys only after an empty submit; the resting form keeps it live
+    // so that submit can happen. The section is the spec, not the field
+    // contents (see note 3 above).
+    const emptyError = state === 'emptyError';
+    const errorText = emptyError ? strings.requiredError : undefined;
     // The label is the country NAME only. The flag is not part of it — it rides
     // the dropdown's leading slot below, where Core paints the raster.
     const options = countries.map((c) => ({
         value: c.value,
         label: c.label,
     }));
-    return (_jsxs(PrizmaFormScreen, { ref: ref, title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, ctaDisabled: empty, ctaLoadingLabel: copy.ctaLoadingLabel, 
+    return (_jsxs(PrizmaFormScreen, { ref: ref, title: copy.title, subtitle: copy.subtitle, ctaLabel: copy.ctaLabel, ctaDisabled: emptyError, ctaLoadingLabel: copy.ctaLoadingLabel, 
         /* Figma draws no verified tag on either form section, but GUIDELINES §1
            and the standing owner rule (#F-30, #PI-8) keep header AND footer on
            every non-capture screen — so nothing shifts between the form, the
            spinner and the verdict. DEVIATIONS #WB-1. */
-        verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: [_jsx(PrizmaDropdown, { label: copy.country.label, placeholder: copy.country.placeholder, options: options, defaultValue: values?.country ?? null, 
+        verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: [_jsx(PrizmaDropdown, { label: copy.country.label, 
+                /* Country and Business Name are required and marked (Elena,
+                   2026-09-30); the H5 explains the asterisk. */
+                required: true, requiredHint: strings.requiredHint, 
+                /* The empty-submit error draws the field with nothing in it, as the
+                   `FormsFieldScreen` `emptyError` precedent does. */
+                placeholder: emptyError ? undefined : copy.country.placeholder, options: options, defaultValue: emptyError ? null : (values?.country ?? null), error: emptyError, errorText: errorText, 
                 /* A country catalogue is long enough that Core's own search bar is
                    the right behaviour; no purple section draws the menu open, so
                    nothing about its appearance is being invented here. */
@@ -79,7 +91,9 @@ export const WatchlistBusinessFormScreen = forwardRef(({ strings, state = 'defau
                             dialCode: '',
                             flag: match.flag ?? '',
                         } })) : null;
-                } }), _jsx(PrizmaTextField, { label: copy.businessName.label, placeholder: copy.businessName.placeholder, autoComplete: "organization", defaultValue: values?.businessName ?? '' }), _jsx(PrizmaTextField, { label: copy.taxId.label, placeholder: copy.taxId.placeholder, autoComplete: "off", autoCapitalize: "characters", spellCheck: false, defaultValue: values?.taxId ?? '' })] }));
+                } }), _jsx(PrizmaTextField, { label: copy.businessName.label, required: true, requiredHint: strings.requiredHint, placeholder: emptyError ? undefined : copy.businessName.placeholder, autoComplete: "organization", defaultValue: emptyError ? '' : (values?.businessName ?? ''), error: emptyError, errorText: errorText }), _jsx(PrizmaTextField, { label: copy.taxId.label, placeholder: copy.taxId.placeholder, autoComplete: "off", autoCapitalize: "characters", spellCheck: false, 
+                /* Optional (#WB-2): an empty submit leaves it clean. */
+                defaultValue: emptyError ? '' : (values?.taxId ?? '') })] }));
 });
 WatchlistBusinessFormScreen.displayName = 'WatchlistBusinessFormScreen';
 export default WatchlistBusinessFormScreen;

package/dist/WatchlistBusinessStrings.d.ts

@@ -4,15 +4,18 @@
  * in field content and whether the CTA is live, which is exactly what
  * GUIDELINES §6-E means by "states are separate screens sharing the identical
  * layout":
- * - `default` — every field empty (the country dropdown on its placeholder),
- *   CTA greyed
- * - `filled`  — country selected and business name typed, CTA live
+ * - `default`    — every field empty (the country dropdown on its placeholder),
+ *   CTA live so the user can press it (GUIDELINES §6-E empty-submit rule)
+ * - `filled`     — country selected and business name typed, CTA live
+ * - `emptyError` — the user pressed the CTA with the form empty: Country and
+ *   Business Name render empty in Core's error state with `requiredError`,
+ *   Tax ID stays clean, CTA greyed (Elena 2026-09-30)
  *
  * Note what `filled` does NOT do: it leaves **Tax ID empty** and still enables
  * the CTA, so the tax identifier is optional and does not gate the lookup
- * (DEVIATIONS #WB-2).
+ * (DEVIATIONS #WB-2). That is also why `emptyError` leaves Tax ID alone.
  */
-export type WatchlistBusinessFormState = 'default' | 'filled';
+export type WatchlistBusinessFormState = 'default' | 'filled' | 'emptyError';
 /**
  * One selectable country of registration. Runtime data, never copy — the host
  * owns the catalogue (a full ISO list is not a string table), exactly as Phone
@@ -58,11 +61,22 @@ export interface WatchlistBusinessStrings {
     verifiedLabel: string;
     /** Accessible name for the logo nav row. */
     navLabel?: string;
-    /** watchlist.{default,filled} */
+    /**
+     * The error row the REQUIRED fields (Country, Business Name) show on the
+     * `emptyError` form state ("This field is required"). Maps to the SDK's
+     * `dynamicForms.fieldRequired` key. GUIDELINES §6-E empty-submit rule.
+     */
+    requiredError: string;
+    /**
+     * Required-field marker ("*"), passed to Core's own `requiredHint` prop on
+     * Country and Business Name (Elena, 2026-09-30).
+     */
+    requiredHint?: string;
+    /** watchlist.{default,filled,emptyError} */
     form: {
         /** H2 ("Watchlist for business"). */
         title: string;
-        /** H5 — the purple sections draw none, kept for hosts that want one. */
+        /** H5 ("All fields marked with * are required."), explains the asterisk. */
         subtitle?: string;
         country: WatchlistBusinessFieldStrings & {
             /** Search placeholder inside the open menu. */

package/dist/index.d.ts

@@ -109,7 +109,7 @@ export { type WatchlistBusinessFormState, type WatchlistBusinessCountry, type Wa
 export { WatchlistBusinessFormScreen, type WatchlistBusinessFormScreenProps } from './WatchlistBusinessFormScreen';
 export { WatchlistBusinessProcessingScreen, type WatchlistBusinessProcessingScreenProps } from './WatchlistBusinessProcessingScreen';
 export { WatchlistBusinessSuccessScreen, type WatchlistBusinessSuccessScreenProps } from './WatchlistBusinessSuccessScreen';
-export { type VideoSelfieDocumentType, type VideoSelfieTutorialRow, type VideoSelfieTutorialRowKind, type VideoSelfieFeedbackKind, type VideoSelfieIdSide, type VideoSelfieIdErrorSeverity, type VideoSelfieSpeakFamily, type VideoSelfieStepsOs, type VideoSelfieStepsStrings, type VideoSelfieSpeakStrings, type VideoSelfieStrings, } from './VideoSelfieStrings';
+export { type VideoSelfieDocumentType, type VideoSelfieTutorialRow, type VideoSelfieTutorialRowKind, type VideoSelfieFeedbackKind, type VideoSelfieIdSide, type VideoSelfieConditionCopy, type VideoSelfieIdCondition, type VideoSelfieIdErrorReason, type VideoSelfieIdErrorSeverity, type VideoSelfieTurnDirection, type VideoSelfieSpeakFamily, type VideoSelfieStepsOs, type VideoSelfieStepsStrings, type VideoSelfieSpeakStrings, type VideoSelfieStrings, } from './VideoSelfieStrings';
 export { VideoSelfieCameraStepsScreen, type VideoSelfieCameraStepsScreenProps } from './VideoSelfieCameraStepsScreen';
 export { VideoSelfieErrorScreen, type VideoSelfieErrorVariant, type VideoSelfieErrorScreenProps, } from './VideoSelfieErrorScreen';
 export { VideoSelfieFlipCameraScreen, type VideoSelfieFlipCameraScreenProps } from './VideoSelfieFlipCameraScreen';
@@ -123,6 +123,8 @@ export { VideoSelfieSelfieCaptureScreen, type VideoSelfieSelfieState, type Video
 export { VideoSelfieSpeakScreen, type VideoSelfieSpeakStage, type VideoSelfieSpeakScreenProps, } from './VideoSelfieSpeakScreen';
 export { VideoSelfieSuccessScreen, type VideoSelfieSuccessScreenProps } from './VideoSelfieSuccessScreen';
 export { VideoSelfieTutorialScreen, type VideoSelfieTutorialScreenProps } from './VideoSelfieTutorialScreen';
+export { VideoSelfieTurnHeadScreen, type VideoSelfieTurnStage, type VideoSelfieTurnHeadScreenProps, } from './VideoSelfieTurnHeadScreen';
+export { VideoSelfieWaveScreen, type VideoSelfieWaveStage, type VideoSelfieWaveScreenProps, } from './VideoSelfieWaveScreen';
 export { type NfcDocumentType, type NfcIssueKind, type NfcIssueStrings, type NfcHeadingStrings, type NfcStrings, } from './NfcStrings';
 export { NfcCommonIssuesScreen, type NfcCommonIssuesScreenProps } from './NfcCommonIssuesScreen';
 export { NfcErrorScreen, type NfcErrorVariant, type NfcErrorScreenProps, } from './NfcErrorScreen';

package/dist/index.js

@@ -112,6 +112,8 @@ export { VideoSelfieSelfieCaptureScreen, } from './VideoSelfieSelfieCaptureScree
 export { VideoSelfieSpeakScreen, } from './VideoSelfieSpeakScreen';
 export { VideoSelfieSuccessScreen } from './VideoSelfieSuccessScreen';
 export { VideoSelfieTutorialScreen } from './VideoSelfieTutorialScreen';
+export { VideoSelfieTurnHeadScreen, } from './VideoSelfieTurnHeadScreen';
+export { VideoSelfieWaveScreen, } from './VideoSelfieWaveScreen';
 export { NfcCommonIssuesScreen } from './NfcCommonIssuesScreen';
 export { NfcErrorScreen, } from './NfcErrorScreen';
 export { NfcProcessingScreen } from './NfcProcessingScreen';

package/dist/types.d.ts

@@ -10,7 +10,9 @@ import type { ReactNode } from 'react';
  * they collapsed into one indistinguishable event. DEVIATIONS #PI-10.
  */
 export interface PrizmaScreenAction {
-    type: 'cta' | 'secondary' | 'tertiary' | 'auto' | 'help';
+    /** `back` — the nav's back chevron, on the screens that opt into one
+     *  (`PrizmaScreenNav.backLabel`). */
+    type: 'cta' | 'secondary' | 'tertiary' | 'auto' | 'help' | 'back';
     /** Stable per-screen identifier, e.g. `face-capture-tutorial`. */
     screenId?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/prizma-core-screens",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "description": "Prizma Design System — SDK module screens: composed, responsive, brand-themeable React screens built from @incodetech/prizma-core-web.",
   "license": "UNLICENSED",
   "type": "module",
@@ -655,11 +655,21 @@
       "types": "./dist/VideoSelfieSuccessScreen.d.ts",
       "import": "./dist/VideoSelfieSuccessScreen.js"
     },
+    "./video-selfie-turn-head-screen": {
+      "source": "./src/VideoSelfieTurnHeadScreen.tsx",
+      "types": "./dist/VideoSelfieTurnHeadScreen.d.ts",
+      "import": "./dist/VideoSelfieTurnHeadScreen.js"
+    },
     "./video-selfie-tutorial-screen": {
       "source": "./src/VideoSelfieTutorialScreen.tsx",
       "types": "./dist/VideoSelfieTutorialScreen.d.ts",
       "import": "./dist/VideoSelfieTutorialScreen.js"
     },
+    "./video-selfie-wave-screen": {
+      "source": "./src/VideoSelfieWaveScreen.tsx",
+      "types": "./dist/VideoSelfieWaveScreen.d.ts",
+      "import": "./dist/VideoSelfieWaveScreen.js"
+    },
     "./viewfinder-screen": {
       "source": "./src/ViewfinderScreen.tsx",
       "types": "./dist/ViewfinderScreen.d.ts",
@@ -721,6 +731,7 @@
     "./samples/selfie-mask.png": "./samples/selfie-mask.png",
     "./samples/selfie.png": "./samples/selfie.png",
     "./samples/video-selfie-camera.png": "./samples/video-selfie-camera.png",
+    "./samples/video-selfie-room.png": "./samples/video-selfie-room.png",
     "./package.json": "./package.json"
   },
   "files": [
@@ -739,8 +750,8 @@
   },
   "dependencies": {
     "@incodetech/prizma-core-icons": "^0.4.0",
-    "@incodetech/prizma-core-tokens": "^0.12.0",
-    "@incodetech/prizma-core-web": "^0.12.0"
+    "@incodetech/prizma-core-tokens": "^0.13.0",
+    "@incodetech/prizma-core-web": "^0.13.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.12",

package/src/CurpEnterScreen.tsx

@@ -54,6 +54,13 @@ export interface CurpEnterScreenProps
  * `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<HTMLDivElement, CurpEnterScreenProps>(
   (
@@ -77,6 +84,9 @@ export const CurpEnterScreen = forwardRef<HTMLDivElement, CurpEnterScreenProps>(
     // 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 (
@@ -100,6 +110,7 @@ export const CurpEnterScreen = forwardRef<HTMLDivElement, CurpEnterScreenProps>(
         ctaLabel={strings.enter.ctaLabel}
         /* The `loading` section swaps the CTA label for Core's spinner. */
         ctaLoading={busy}
+        ctaDisabled={emptyError}
         ctaLoadingLabel={strings.enter.ctaLoadingLabel}
         linkContent={
           <PrizmaButton
@@ -125,15 +136,21 @@ export const CurpEnterScreen = forwardRef<HTMLDivElement, CurpEnterScreenProps>(
              carry the meaning — so the copy rides `aria-label` rather than
              Core's visible `label` slot (DEVIATIONS #PI-4). */
           aria-label={strings.enter.fieldLabel}
-          placeholder={strings.enter.placeholder}
-          defaultValue={value ?? ''}
+          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}
+          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/src/CurpGenerateScreen.tsx

@@ -56,6 +56,14 @@ export interface CurpGenerateScreenProps
  * 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<HTMLDivElement, CurpGenerateScreenProps>(
   (
@@ -75,21 +83,30 @@ export const CurpGenerateScreen = forwardRef<HTMLDivElement, CurpGenerateScreenP
   ) => {
     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?: string) => (emptyError ? undefined : placeholder);
+    const err = {
+      error: emptyError,
+      errorText: emptyError ? strings.requiredError : undefined,
+    };
+
     return (
       <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. */
+        /* 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
         className={[
           'curp-generate',
-          'curp-generate--scroll',
           state === 'dropdown' ? 'curp-generate--menu-open' : '',
           className,
         ]
@@ -98,6 +115,7 @@ export const CurpGenerateScreen = forwardRef<HTMLDivElement, CurpGenerateScreenP
         title={copy.title}
         subtitle={copy.subtitle}
         ctaLabel={copy.ctaLabel}
+        ctaDisabled={emptyError}
         ctaLoadingLabel={copy.ctaLoadingLabel}
         verifiedLabel={strings.verifiedLabel}
         navLabel={strings.navLabel}
@@ -112,54 +130,60 @@ export const CurpGenerateScreen = forwardRef<HTMLDivElement, CurpGenerateScreenP
             (DEVIATIONS #PI-6). */}
         <PrizmaTextField
           label={copy.firstName.label}
-          placeholder={copy.firstName.placeholder}
+          placeholder={ph(copy.firstName.placeholder)}
           required
           requiredHint={strings.requiredHint}
           autoComplete="off"
-          defaultValue={values?.firstName ?? ''}
+          defaultValue={emptyError ? '' : values?.firstName ?? ''}
+          {...err}
         />
         <PrizmaTextField
           label={copy.firstLastName.label}
-          placeholder={copy.firstLastName.placeholder}
+          placeholder={ph(copy.firstLastName.placeholder)}
           required
           requiredHint={strings.requiredHint}
           autoComplete="off"
-          defaultValue={values?.firstLastName ?? ''}
+          defaultValue={emptyError ? '' : values?.firstLastName ?? ''}
+          {...err}
         />
         <PrizmaTextField
           label={copy.secondLastName.label}
-          placeholder={copy.secondLastName.placeholder}
+          placeholder={ph(copy.secondLastName.placeholder)}
           required
           requiredHint={strings.requiredHint}
           autoComplete="off"
-          defaultValue={values?.secondLastName ?? ''}
+          defaultValue={emptyError ? '' : values?.secondLastName ?? ''}
+          {...err}
         />
         <PrizmaDropdown
           label={copy.gender.label}
-          placeholder={copy.gender.placeholder}
+          placeholder={ph(copy.gender.placeholder)}
           required
           requiredHint={strings.requiredHint}
           options={genders}
-          defaultValue={values?.gender ?? null}
+          defaultValue={emptyError ? null : values?.gender ?? null}
+          {...err}
           searchPlaceholder={copy.gender.searchPlaceholder}
           /* The `dropdown` section is the open Gender menu. */
           forceOpen={state === 'dropdown'}
         />
         <PrizmaDateField
           label={copy.dateOfBirth.label}
-          placeholder={copy.dateOfBirth.placeholder}
+          placeholder={ph(copy.dateOfBirth.placeholder)}
           required
           requiredHint={strings.requiredHint}
           calendarLabel={copy.dateOfBirth.calendarLabel}
-          defaultValue={values?.dateOfBirth ?? ''}
+          defaultValue={emptyError ? '' : values?.dateOfBirth ?? ''}
+          {...err}
         />
         <PrizmaDropdown
           label={copy.birthState.label}
-          placeholder={copy.birthState.placeholder}
+          placeholder={ph(copy.birthState.placeholder)}
           required
           requiredHint={strings.requiredHint}
           options={states}
-          defaultValue={values?.birthState ?? null}
+          defaultValue={emptyError ? null : values?.birthState ?? null}
+          {...err}
           searchable
           searchPlaceholder={copy.birthState.searchPlaceholder}
         />

package/src/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/src/CurpStrings.ts

@@ -27,16 +27,30 @@
  * - `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
@@ -96,6 +110,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: {

package/src/EkybAddressDetailsScreen.tsx

@@ -82,6 +82,13 @@ export interface EkybAddressDetailsScreenProps
  * 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<
   HTMLDivElement,
@@ -91,9 +98,10 @@ export const EkybAddressDetailsScreen = forwardRef<
     {
       strings,
       state = 'empty',
-      values,
+      values: valuesProp,
       states = [],
       screenId = `ekyb-address-${state}`,
+      ctaDisabled,
       className,
       overrides,
       onAction,
@@ -102,6 +110,14 @@ export const EkybAddressDetailsScreen = forwardRef<
     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 (
       <PrizmaFormScreen
@@ -122,6 +138,8 @@ export const EkybAddressDetailsScreen = forwardRef<
         title={copy.title}
         subtitle={copy.subtitle}
         ctaLabel={copy.ctaLabel}
+        /* Disabled only after the empty submit; `empty` keeps it enabled. */
+        ctaDisabled={emptyError || ctaDisabled}
         linkContent={
           <PrizmaButton
             variant="secondary"
@@ -136,17 +154,20 @@ export const EkybAddressDetailsScreen = forwardRef<
         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. */
+        /* 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
         {...shell}
       >
+        <PrizmaFormRow>
         <PrizmaTextField
           label={copy.street.label}
           placeholder={copy.street.placeholder}
           required
           requiredHint={strings.requiredHint}
+          {...missing}
           autoComplete="off"
           defaultValue={values?.street ?? ''}
         />
@@ -155,9 +176,12 @@ export const EkybAddressDetailsScreen = forwardRef<
           placeholder={copy.houseNumber.placeholder}
           required
           requiredHint={strings.requiredHint}
+          {...missing}
           autoComplete="off"
           defaultValue={values?.houseNumber ?? ''}
         />
+        </PrizmaFormRow>
+        <PrizmaFormRow>
         {/* The one field 6340:50731 draws without an asterisk. */}
         <PrizmaTextField
           label={copy.addressLine2.label}
@@ -170,15 +194,18 @@ export const EkybAddressDetailsScreen = forwardRef<
           placeholder={copy.city.placeholder}
           required
           requiredHint={strings.requiredHint}
+          {...missing}
           autoComplete="off"
           defaultValue={values?.city ?? ''}
         />
+        </PrizmaFormRow>
         <PrizmaFormRow>
         <PrizmaDropdown
           label={copy.state.label}
           placeholder={copy.state.placeholder}
           required
           requiredHint={strings.requiredHint}
+          {...missing}
           options={states}
           /* Both sections draw the placeholder unless the host supplies a
              value — see the docstring note on 6340:38197. */
@@ -193,6 +220,7 @@ export const EkybAddressDetailsScreen = forwardRef<
           placeholder={copy.postalCode.placeholder}
           required
           requiredHint={strings.requiredHint}
+          {...missing}
           autoComplete="off"
           defaultValue={values?.postalCode ?? ''}
         />