@incodetech/prizma-core-screens 0.2.4 → 0.2.12

package/dist/DemoScreensRedirectScreen.js

@@ -31,8 +31,9 @@ export const DemoScreensRedirectScreen = forwardRef(({ strings, stage = 'qr', sm
         { code: 'RS', name: 'Serbia', dialCode: '+381', flag: '' },
     ].find(c => c.code === r.countryCode);
     const subtitle = sms ? r.subtitle : desktop ? r.subtitleQrDesktop : r.subtitleQrOnly;
-    const verdict = stage === 'sent' || stage === 'resend' || stage === 'resent' || stage === 'tooMany';
-    return (_jsxs(PrizmaScreenShell, { ref: ref, "data-screen-id": screenId, className: ['demo-screens-redirect', className ?? ''].filter(Boolean).join(' '), ...shell, children: [stage === 'resent' ? (_jsx("div", { className: "demo-screens-toast demo-screens-toast--desktop", children: _jsx(PrizmaSnackbar, { state: "success", children: r.sent.resentSnackbar }) })) : null, _jsxs("div", { className: "demo-screens-redirect__card", children: [_jsx(PrizmaScreenNav, { logo: overrides?.logo, navLabel: strings.navLabel }), _jsxs("div", { className: "prizma-screen-layout__content demo-screens-redirect__content", children: [_jsx(PrizmaTitle, { variant: "centered", title: r.title, showSubtitle: true, subtitle: subtitle }), sms ? (_jsxs("div", { className: "demo-screens-tabs", role: "tablist", children: [_jsx("button", { type: "button", role: "tab", "aria-selected": !onSms, className: ['demo-screens-tabs__tab', !onSms ? 'demo-screens-tabs__tab--active' : ''].join(' '), onClick: () => onAction?.({ type: 'secondary', screenId }), children: r.tabs.qr }), _jsx("button", { type: "button", role: "tab", "aria-selected": onSms, className: ['demo-screens-tabs__tab', onSms ? 'demo-screens-tabs__tab--active' : ''].join(' '), onClick: () => onAction?.({ type: 'tertiary', screenId }), children: r.tabs.sms })] })) : null, stage === 'qr' ? (_jsxs("div", { className: "demo-screens-redirect__leg", children: [sms ? _jsx("p", { className: "demo-screens-redirect__hint", children: r.qrHint }) : null, _jsx("div", { className: "demo-screens-redirect__qr", "aria-label": r.tabs.qr, children: qr })] })) : null, stage === 'sms' || stage === 'smsFilled' ? (_jsxs("div", { className: "demo-screens-redirect__leg demo-screens-redirect__leg--form", children: [_jsx("p", { className: "demo-screens-redirect__hint", children: r.smsHint }), _jsx(PrizmaCombined, { "aria-label": r.phoneLabel, placeholder: r.phonePlaceholder, defaultValue: stage === 'smsFilled' ? r.phoneValue : '', defaultCountry: country, showRequiredMarker: false }, stage), _jsx(PrizmaButton, { variant: "primary", size: "L", disabled: stage !== 'smsFilled', onClick: () => onAction?.({ type: 'cta', screenId }), children: r.sendLabel })] })) : null, verdict ? (_jsxs("div", { className: "demo-screens-redirect__leg demo-screens-redirect__leg--verdict", children: [stage === 'tooMany' ? (_jsx(PrizmaTitle, { variant: "centered", title: r.tooMany.title, showSubtitle: true, subtitle: r.tooMany.subtitle, icon: { type: 'status', status: 'error' } })) : (_jsx(PrizmaTitle, { variant: "centered", title: r.sent.title, showSubtitle: true, subtitle: `${r.sent.toPrefix} ${country?.dialCode ?? ''} ${r.phoneValue}`.trim(), icon: { type: 'status', status: 'success' } })), stage === 'tooMany' ? (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", onClick: () => onAction?.({ type: 'tertiary', screenId }), children: r.tooMany.changeLabel })) : stage === 'sent' || stage === 'resent' ? (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", disabled: true, children: r.sent.resendIn })) : (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", onClick: () => onAction?.({ type: 'cta', screenId }), children: r.sent.resend }))] })) : null] }), _jsxs("div", { className: "prizma-screen-layout__band demo-screens-redirect__band", children: [desktop && !verdict ? (_jsxs(_Fragment, { children: [_jsx(PrizmaDisclaimer, { text: r.orLabel }), _jsx("div", { className: "prizma-screen-layout__band__ctas", children: _jsx(PrizmaButton, { variant: "secondary", size: "L", onClick: () => onAction?.({ type: 'secondary', screenId }), children: r.desktopLabel }) })] })) : null, _jsx("div", { className: "prizma-screen-layout__band__tag", children: _jsx(PrizmaTag, { label: strings.verifiedLabel }) })] })] })] }));
+    const invalid = stage === 'invalidUuid';
+    const verdict = stage === 'sent' || stage === 'resend' || stage === 'resent' || stage === 'tooMany' || invalid;
+    return (_jsxs(PrizmaScreenShell, { ref: ref, "data-screen-id": screenId, className: ['demo-screens-redirect', className ?? ''].filter(Boolean).join(' '), ...shell, children: [stage === 'resent' ? (_jsx("div", { className: "demo-screens-toast demo-screens-toast--desktop", children: _jsx(PrizmaSnackbar, { state: "success", children: r.sent.resentSnackbar }) })) : null, _jsxs("div", { className: "demo-screens-redirect__card", children: [_jsx(PrizmaScreenNav, { logo: overrides?.logo, navLabel: strings.navLabel }), _jsxs("div", { className: "prizma-screen-layout__content demo-screens-redirect__content", children: [invalid ? null : _jsx(PrizmaTitle, { variant: "centered", title: r.title, showSubtitle: true, subtitle: subtitle }), sms && !invalid ? (_jsxs("div", { className: "demo-screens-tabs", role: "tablist", children: [_jsx("button", { type: "button", role: "tab", "aria-selected": !onSms, className: ['demo-screens-tabs__tab', !onSms ? 'demo-screens-tabs__tab--active' : ''].join(' '), onClick: () => onAction?.({ type: 'secondary', screenId }), children: r.tabs.qr }), _jsx("button", { type: "button", role: "tab", "aria-selected": onSms, className: ['demo-screens-tabs__tab', onSms ? 'demo-screens-tabs__tab--active' : ''].join(' '), onClick: () => onAction?.({ type: 'tertiary', screenId }), children: r.tabs.sms })] })) : null, stage === 'qr' ? (_jsxs("div", { className: "demo-screens-redirect__leg", children: [sms ? _jsx("p", { className: "demo-screens-redirect__hint", children: r.qrHint }) : null, _jsx("div", { className: "demo-screens-redirect__qr", "aria-label": r.tabs.qr, children: qr })] })) : null, stage === 'sms' || stage === 'smsFilled' ? (_jsxs("div", { className: "demo-screens-redirect__leg demo-screens-redirect__leg--form", children: [_jsx("p", { className: "demo-screens-redirect__hint", children: r.smsHint }), _jsx(PrizmaCombined, { "aria-label": r.phoneLabel, placeholder: r.phonePlaceholder, defaultValue: stage === 'smsFilled' ? r.phoneValue : '', defaultCountry: country, showRequiredMarker: false }, stage), _jsx(PrizmaButton, { variant: "primary", size: "L", disabled: stage !== 'smsFilled', onClick: () => onAction?.({ type: 'cta', screenId }), children: r.sendLabel })] })) : null, verdict ? (_jsxs("div", { className: "demo-screens-redirect__leg demo-screens-redirect__leg--verdict", children: [invalid ? (_jsx(PrizmaTitle, { variant: "centered", title: r.invalidUuid.title, showSubtitle: true, subtitle: r.invalidUuid.subtitle, icon: { type: 'status', status: 'error' } })) : stage === 'tooMany' ? (_jsx(PrizmaTitle, { variant: "centered", title: r.tooMany.title, showSubtitle: true, subtitle: r.tooMany.subtitle, icon: { type: 'status', status: 'error' } })) : (_jsx(PrizmaTitle, { variant: "centered", title: r.sent.title, showSubtitle: true, subtitle: `${r.sent.toPrefix} ${country?.dialCode ?? ''} ${r.phoneValue}`.trim(), icon: { type: 'status', status: 'success' } })), invalid ? null : stage === 'tooMany' ? (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", onClick: () => onAction?.({ type: 'tertiary', screenId }), children: r.tooMany.changeLabel })) : stage === 'sent' || stage === 'resent' ? (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", disabled: true, children: r.sent.resendIn })) : (_jsx(PrizmaButton, { variant: "tertiary-link", size: "L", onClick: () => onAction?.({ type: 'cta', screenId }), children: r.sent.resend }))] })) : null] }), _jsxs("div", { className: "prizma-screen-layout__band demo-screens-redirect__band", children: [desktop && !verdict ? (_jsxs(_Fragment, { children: [_jsx(PrizmaDisclaimer, { text: r.orLabel }), _jsx("div", { className: "prizma-screen-layout__band__ctas", children: _jsx(PrizmaButton, { variant: "secondary", size: "L", onClick: () => onAction?.({ type: 'secondary', screenId }), children: r.desktopLabel }) })] })) : null, _jsx("div", { className: "prizma-screen-layout__band__tag", children: _jsx(PrizmaTag, { label: strings.verifiedLabel }) })] })] })] }));
 });
 DemoScreensRedirectScreen.displayName = 'DemoScreensRedirectScreen';
 export default DemoScreensRedirectScreen;

package/dist/DemoScreensStrings.d.ts

@@ -150,6 +150,11 @@ export interface DemoScreensStrings {
             subtitle: string;
             changeLabel: string;
         };
+        /** The link's UUID was rejected: the same copy for Flows and Workflows. */
+        invalidUuid: {
+            title: string;
+            subtitle: string;
+        };
     };
     /** WEB · `demo_2` — the front door: language, the wordmark, one CTA. */
     start: {

package/dist/DigitalIdUploadErrorScreen.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { type PrizmaReviewScreenProps } from './ReviewScreen';
+import type { PrizmaScreenActionHandler, PrizmaScreenOverrides } from './types';
+import type { DigitalIdUploadStrings } from './DigitalIdUploadStrings';
+import './ScreenLayout.css';
+export interface DigitalIdUploadErrorScreenProps extends Omit<PrizmaReviewScreenProps, 'stage' | 'title' | 'subtitle' | 'successTitle' | 'analyzingLabel' | 'primaryLabel' | 'secondaryLabel' | 'verifiedLabel' | 'children'> {
+    /** Module copy — this screen reads the `error` slice. */
+    strings: DigitalIdUploadStrings;
+    screenId?: string;
+    overrides?: PrizmaScreenOverrides;
+    onAction?: PrizmaScreenActionHandler;
+}
+/**
+ * Digital ID Upload — the uploaded file was rejected, built on the
+ * `PrizmaReviewScreen` archetype's `error` stage (GUIDELINES.md §6-H). Figma:
+ * `Upload Digital ID` file (wxFsHRvllern4VnjRqM4JO), `Errors` section,
+ * `Error` frame (node 25874:11957).
+ *
+ * Kept separate from `DigitalIdUploadReviewScreen` (the confirm flow) rather
+ * than folded into it as a fourth stage of that wrapper — same split Document
+ * Capture draws between its confirm screens and
+ * `DocumentCaptureGenericErrorScreen`, even though here both wrappers happen
+ * to share the same archetype under the hood. The media is
+ * `PrizmaCaptureDigitalId state="error"` (red 4px border) — the same managed
+ * component every other stage uses, not a bespoke verdict illustration — and
+ * the header/footer are hidden exactly like `analyzing`/`success`
+ * (`centeredWhenNoNav`, since this Figma frame draws the identical symmetric
+ * header/media/CTA skeleton).
+ */
+export declare const DigitalIdUploadErrorScreen: React.ForwardRefExoticComponent<DigitalIdUploadErrorScreenProps & React.RefAttributes<HTMLDivElement>>;
+export default DigitalIdUploadErrorScreen;

package/dist/DigitalIdUploadErrorScreen.js

@@ -0,0 +1,26 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { PrizmaCaptureDigitalId } from '@incodetech/prizma-core-web/capture-digital-id';
+import { PrizmaReviewScreen } from './ReviewScreen';
+import './ScreenLayout.css';
+/**
+ * Digital ID Upload — the uploaded file was rejected, built on the
+ * `PrizmaReviewScreen` archetype's `error` stage (GUIDELINES.md §6-H). Figma:
+ * `Upload Digital ID` file (wxFsHRvllern4VnjRqM4JO), `Errors` section,
+ * `Error` frame (node 25874:11957).
+ *
+ * Kept separate from `DigitalIdUploadReviewScreen` (the confirm flow) rather
+ * than folded into it as a fourth stage of that wrapper — same split Document
+ * Capture draws between its confirm screens and
+ * `DocumentCaptureGenericErrorScreen`, even though here both wrappers happen
+ * to share the same archetype under the hood. The media is
+ * `PrizmaCaptureDigitalId state="error"` (red 4px border) — the same managed
+ * component every other stage uses, not a bespoke verdict illustration — and
+ * the header/footer are hidden exactly like `analyzing`/`success`
+ * (`centeredWhenNoNav`, since this Figma frame draws the identical symmetric
+ * header/media/CTA skeleton).
+ */
+export const DigitalIdUploadErrorScreen = forwardRef(({ strings, screenId = 'digital-id-upload-error', showHeader = false, showFooter = false, overrides, onAction, ...shell }, ref) => (_jsx(PrizmaReviewScreen, { ref: ref, stage: "error", title: strings.error.title, subtitle: strings.error.subtitle, primaryLabel: strings.error.ctaLabel, centeredWhenNoNav: true, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, showHeader: showHeader, showFooter: showFooter, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: _jsx(PrizmaCaptureDigitalId, { state: "error" }) })));
+DigitalIdUploadErrorScreen.displayName = 'DigitalIdUploadErrorScreen';
+export default DigitalIdUploadErrorScreen;

package/dist/DigitalIdUploadFileTooLargeScreen.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import { type PrizmaResultScreenProps } from './ResultScreen';
+import type { PrizmaScreenActionHandler, PrizmaScreenOverrides } from './types';
+import type { DigitalIdUploadStrings } from './DigitalIdUploadStrings';
+import './ScreenLayout.css';
+export interface DigitalIdUploadFileTooLargeScreenProps extends Omit<PrizmaResultScreenProps, 'status' | 'title' | 'subtitle' | 'ctaLabel' | 'verifiedLabel' | 'navLabel'> {
+    /** Module copy — this screen reads the `fileTooLarge` slice. */
+    strings: DigitalIdUploadStrings;
+    screenId?: string;
+    overrides?: PrizmaScreenOverrides;
+    onAction?: PrizmaScreenActionHandler;
+}
+/**
+ * Digital ID Upload — the selected file exceeds the size limit, built on the
+ * `PrizmaResultScreen` archetype (GUIDELINES.md §6-F). Figma: `Upload Digital
+ * ID` file (wxFsHRvllern4VnjRqM4JO), `Errors` section, `File Limit Error`
+ * frame (node 26083:3981).
+ *
+ * Unlike `DigitalIdUploadErrorScreen` (the rejected-document verdict, built on
+ * the Review archetype because it reuses `PrizmaCaptureDigitalId`), this
+ * screen never had a file to show — the size check runs before anything
+ * uploads — so Figma draws the plain F recipe: status icon + title + subtitle
+ * centred in the full height, one CTA pinned near the bottom. No media slot,
+ * no card, nothing to reuse from the capture component.
+ */
+export declare const DigitalIdUploadFileTooLargeScreen: React.ForwardRefExoticComponent<DigitalIdUploadFileTooLargeScreenProps & React.RefAttributes<HTMLDivElement>>;
+export default DigitalIdUploadFileTooLargeScreen;

package/dist/DigitalIdUploadFileTooLargeScreen.js

@@ -0,0 +1,21 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { PrizmaResultScreen } from './ResultScreen';
+import './ScreenLayout.css';
+/**
+ * Digital ID Upload — the selected file exceeds the size limit, built on the
+ * `PrizmaResultScreen` archetype (GUIDELINES.md §6-F). Figma: `Upload Digital
+ * ID` file (wxFsHRvllern4VnjRqM4JO), `Errors` section, `File Limit Error`
+ * frame (node 26083:3981).
+ *
+ * Unlike `DigitalIdUploadErrorScreen` (the rejected-document verdict, built on
+ * the Review archetype because it reuses `PrizmaCaptureDigitalId`), this
+ * screen never had a file to show — the size check runs before anything
+ * uploads — so Figma draws the plain F recipe: status icon + title + subtitle
+ * centred in the full height, one CTA pinned near the bottom. No media slot,
+ * no card, nothing to reuse from the capture component.
+ */
+export const DigitalIdUploadFileTooLargeScreen = forwardRef(({ strings, screenId = 'digital-id-upload-file-too-large', showHeader = false, showFooter = false, overrides, onAction, ...shell }, ref) => (_jsx(PrizmaResultScreen, { ref: ref, status: "error", title: strings.fileTooLarge.title, subtitle: strings.fileTooLarge.subtitle, ctaLabel: strings.fileTooLarge.ctaLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, showHeader: showHeader, showFooter: showFooter, screenId: screenId, overrides: overrides, onAction: onAction, ...shell })));
+DigitalIdUploadFileTooLargeScreen.displayName = 'DigitalIdUploadFileTooLargeScreen';
+export default DigitalIdUploadFileTooLargeScreen;

package/dist/DigitalIdUploadReviewScreen.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import { type PrizmaReviewScreenProps } from './ReviewScreen';
+import type { PrizmaScreenActionHandler, PrizmaScreenOverrides } from './types';
+import type { DigitalIdUploadConfirmStage, DigitalIdUploadStrings } from './DigitalIdUploadStrings';
+import './ScreenLayout.css';
+export interface DigitalIdUploadReviewScreenProps extends Omit<PrizmaReviewScreenProps, 'title' | 'subtitle' | 'successTitle' | 'analyzingLabel' | 'primaryLabel' | 'secondaryLabel' | 'verifiedLabel' | 'children' | 'stage'> {
+    /** Module copy — this screen reads the `review` slice. */
+    strings: DigitalIdUploadStrings;
+    /** Which stage of the confirm flow to render. Default `review`. */
+    stage?: DigitalIdUploadConfirmStage;
+    /** The uploaded file's name, shown under the card on `review` only. Not
+     *  copy — it is runtime data from the picker, so it stays out of
+     *  `strings` (same contract as `DocumentCaptureConfirmUploadScreen`). */
+    filename?: string;
+    /** Loading-bar progress on `analyzing`, 0–100. */
+    progress?: number;
+    screenId?: string;
+    overrides?: PrizmaScreenOverrides;
+    onAction?: PrizmaScreenActionHandler;
+}
+/**
+ * Digital ID Upload — review / analyzing / success, built on the
+ * `PrizmaReviewScreen` archetype (GUIDELINES.md §6-H). Figma: `Upload Digital
+ * ID` file (wxFsHRvllern4VnjRqM4JO), "Web Happy Path - Light Mode" section —
+ * `Review Document` / `Analyzing` / `Success` (nodes 25351:14725/6/7).
+ *
+ * The media stage is Core's `PrizmaCaptureDigitalId` across all three stages
+ * — its own state enum (`review` / `analyzing` / `success`) maps directly
+ * onto the archetype's stage axis, so it already owns the border treatment
+ * (neutral on review, green 4px on analyzing/success), the scan-flash sweep
+ * and the filename row. Nothing is hand-built here, unlike
+ * `DocumentCaptureConfirmUploadScreen`'s bespoke file-card — Core ships a
+ * purpose-built component for this module.
+ *
+ * Header/footer visibility is genuinely per-stage in this Figma (logo nav +
+ * verified tag show on `review`, both are absent on `analyzing` and
+ * `success`) — not a layout choice this file invents, just the existing
+ * `showHeader`/`showFooter` chrome knobs (owner rule 2026-08-18: header and
+ * footer are independently controlled) applied per stage.
+ *
+ * Always opts into the archetype's `centeredWhenNoNav` — it only takes effect
+ * while the nav is hidden (`analyzing`/`success` here), where this Figma
+ * draws the header + media as one group centred with equal space above and
+ * below it, not a pinned header (see ReviewScreen.tsx for the mechanics).
+ * `review` always shows its own nav, so the flag is a no-op there, and the
+ * default `false` leaves Document Capture's existing analyzing/success
+ * screens byte-for-byte unchanged (neither ever hides the nav here).
+ *
+ * GAP (report, not workaround — README rule 2): Figma's `Success` section
+ * also shows a subtitle ("Let's continue") under the success title, but the
+ * shared `PrizmaReviewScreen` archetype only renders a subtitle on
+ * `stage="review"` — every other current consumer's success state has none.
+ * Left unset here pending an owner call on whether to extend the shared
+ * archetype with a `successSubtitle` slot.
+ */
+export declare const DigitalIdUploadReviewScreen: React.ForwardRefExoticComponent<DigitalIdUploadReviewScreenProps & React.RefAttributes<HTMLDivElement>>;
+export default DigitalIdUploadReviewScreen;

package/dist/DigitalIdUploadReviewScreen.js

@@ -0,0 +1,44 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { PrizmaCaptureDigitalId } from '@incodetech/prizma-core-web/capture-digital-id';
+import { PrizmaReviewScreen } from './ReviewScreen';
+import './ScreenLayout.css';
+/**
+ * Digital ID Upload — review / analyzing / success, built on the
+ * `PrizmaReviewScreen` archetype (GUIDELINES.md §6-H). Figma: `Upload Digital
+ * ID` file (wxFsHRvllern4VnjRqM4JO), "Web Happy Path - Light Mode" section —
+ * `Review Document` / `Analyzing` / `Success` (nodes 25351:14725/6/7).
+ *
+ * The media stage is Core's `PrizmaCaptureDigitalId` across all three stages
+ * — its own state enum (`review` / `analyzing` / `success`) maps directly
+ * onto the archetype's stage axis, so it already owns the border treatment
+ * (neutral on review, green 4px on analyzing/success), the scan-flash sweep
+ * and the filename row. Nothing is hand-built here, unlike
+ * `DocumentCaptureConfirmUploadScreen`'s bespoke file-card — Core ships a
+ * purpose-built component for this module.
+ *
+ * Header/footer visibility is genuinely per-stage in this Figma (logo nav +
+ * verified tag show on `review`, both are absent on `analyzing` and
+ * `success`) — not a layout choice this file invents, just the existing
+ * `showHeader`/`showFooter` chrome knobs (owner rule 2026-08-18: header and
+ * footer are independently controlled) applied per stage.
+ *
+ * Always opts into the archetype's `centeredWhenNoNav` — it only takes effect
+ * while the nav is hidden (`analyzing`/`success` here), where this Figma
+ * draws the header + media as one group centred with equal space above and
+ * below it, not a pinned header (see ReviewScreen.tsx for the mechanics).
+ * `review` always shows its own nav, so the flag is a no-op there, and the
+ * default `false` leaves Document Capture's existing analyzing/success
+ * screens byte-for-byte unchanged (neither ever hides the nav here).
+ *
+ * GAP (report, not workaround — README rule 2): Figma's `Success` section
+ * also shows a subtitle ("Let's continue") under the success title, but the
+ * shared `PrizmaReviewScreen` archetype only renders a subtitle on
+ * `stage="review"` — every other current consumer's success state has none.
+ * Left unset here pending an owner call on whether to extend the shared
+ * archetype with a `successSubtitle` slot.
+ */
+export const DigitalIdUploadReviewScreen = forwardRef(({ strings, stage = 'review', filename, progress = 45, showHeader = stage === 'review', showFooter = stage === 'review', screenId = `digital-id-upload-${stage}`, overrides, onAction, ...shell }, ref) => (_jsx(PrizmaReviewScreen, { ref: ref, stage: stage, title: strings.review.title, subtitle: strings.review.subtitle, successTitle: strings.review.successTitle, analyzingLabel: strings.review.analyzingLabel, centeredWhenNoNav: true, progress: progress, primaryLabel: strings.review.ctaLabel, secondaryLabel: strings.review.replaceLabel, verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, showHeader: showHeader, showFooter: showFooter, screenId: screenId, overrides: overrides, onAction: onAction, ...shell, children: _jsx(PrizmaCaptureDigitalId, { state: stage, filename: filename }) })));
+DigitalIdUploadReviewScreen.displayName = 'DigitalIdUploadReviewScreen';
+export default DigitalIdUploadReviewScreen;

package/dist/DigitalIdUploadStrings.d.ts

@@ -0,0 +1,64 @@
+/** The three stages the confirm flow's screen shares — matches
+ *  `PrizmaReviewScreen`'s own `PrizmaReviewStage` (ReviewScreen.tsx). Kept as
+ *  a separate module-scoped type rather than importing it, same convention as
+ *  `DocumentCaptureConfirmStage` (DocumentCaptureStrings.ts). */
+export type DigitalIdUploadConfirmStage = 'review' | 'analyzing' | 'success';
+export interface DigitalIdUploadStrings {
+    /** Accessible name for the logo nav region (i18n — no baked-in English). */
+    navLabel?: string;
+    /** "verified by" attribution copy for the footer tag. */
+    verifiedLabel: string;
+    /** `Tutorial Screen` (node 25351:14722). */
+    tutorial: {
+        title: string;
+        subtitle?: string;
+        /** "Upload PDF" */
+        ctaLabel: string;
+    };
+    /** `Review Document` / `Analyzing` / `Success` (nodes
+     *  25351:14725/14726/14727) — one screen, three stages. */
+    review: {
+        /** `review` title ("Review document"). */
+        title: string;
+        /** `review` description. Figma draws no subtitle on `analyzing` or
+         *  `success` — the shared `PrizmaReviewScreen` archetype already only
+         *  shows one on `review`, so this needs no per-stage handling here. */
+        subtitle?: string;
+        /** Loading-bar caption on `analyzing` ("Analyzing.."). */
+        analyzingLabel: string;
+        /** H2 on `success` ("Successfully processed!"). */
+        successTitle: string;
+        /** Secondary CTA on `review` ("Replace file"). */
+        replaceLabel: string;
+        /** Primary CTA on `review` / `success` ("Continue"). */
+        ctaLabel: string;
+    };
+    /** `Errors` section, `Error` frame (node 25874:11957) — the uploaded file
+     *  itself was rejected (wrong document type). Built on the SAME
+     *  `PrizmaReviewScreen` archetype as `review`, stage `"error"`: the card
+     *  reuses `PrizmaCaptureDigitalId state="error"` (red 4px border), not a
+     *  generic archetype-F verdict screen (DigitalIdUploadErrorScreen.tsx). */
+    error: {
+        /** "ID type is not accepted" */
+        title: string;
+        /** "Please try scanning a different document" */
+        subtitle?: string;
+        /** "Scan your ID" */
+        ctaLabel: string;
+    };
+    /** `Errors` section, `File Limit Error` frame (node 26083:3981) — the file
+     *  was never uploaded at all (client-side size check), so there is no
+     *  rejected document to show. Built on Archetype F (`PrizmaResultScreen`,
+     *  ResultScreen.tsx) rather than the review archetype `error` uses above —
+     *  Figma centres the status + title + subtitle in the full available
+     *  height with no media stage at all, exactly F's shape, not H's
+     *  header-above-a-card one (DigitalIdUploadFileTooLargeScreen.tsx). */
+    fileTooLarge: {
+        /** "File is too large" */
+        title: string;
+        /** "The selected file is larger than 5 MB, please upload a smaller one" */
+        subtitle?: string;
+        /** "Choose another file" */
+        ctaLabel: string;
+    };
+}

package/dist/DigitalIdUploadStrings.js

@@ -0,0 +1,19 @@
+// Digital ID Upload module — copy contract.
+//
+// Every Digital ID Upload screen receives the SAME `strings:
+// DigitalIdUploadStrings` object (rule: all copy via props, no hardcoded
+// English — GUIDELINES.md §9).
+//
+// Authoritative screens: the "Web Happy Path - Light Mode" purple section of
+// the Upload Digital ID Figma file (wxFsHRvllern4VnjRqM4JO, node 25351:14721)
+// — covers `tutorial` and the `review` / `analyzing` / `success` stages of
+// the confirm flow — plus TWO separate `Errors` sections: node 25874:11955
+// (`ID type is not accepted`) and node 26083:3981 (`File Limit Error`, "File
+// is too large"). Three frames of the happy-path section are NOT part of
+// this contract: `1-1-1-how to verify` (a verification-method chooser shared
+// with ID Capture — see IdCaptureDocumentSelectionScreen.tsx, which is one
+// row short of this Figma's version), a native iOS file-browser frame (OS
+// chrome, DEVIATIONS.md #DC-20 precedent), and `1-18-1-id-hold-on` (ID
+// Capture's own server-side-wait screen — dropped from this module by
+// product decision, not a gap to fill).
+export {};

package/dist/DigitalIdUploadTutorialScreen.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import { type PrizmaTutorialScreenProps } from './TutorialScreen';
+import type { PrizmaScreenActionHandler, PrizmaScreenOverrides } from './types';
+import type { DigitalIdUploadStrings } from './DigitalIdUploadStrings';
+import './ScreenLayout.css';
+export interface DigitalIdUploadTutorialScreenProps extends Omit<PrizmaTutorialScreenProps, 'title' | 'subtitle' | 'ctaLabel' | 'illustration' | 'verifiedLabel' | 'navLabel'> {
+    /** Module copy — this screen reads the `tutorial` slice (+ shared labels). */
+    strings: DigitalIdUploadStrings;
+    screenId?: string;
+    overrides?: PrizmaScreenOverrides;
+    onAction?: PrizmaScreenActionHandler;
+}
+/**
+ * Digital ID Upload — tutorial, built on the `PrizmaTutorialScreen` archetype
+ * (GUIDELINES.md §6-A). Figma: `Upload Digital ID` file
+ * (wxFsHRvllern4VnjRqM4JO), "Web Happy Path - Light Mode" section, `Tutorial
+ * Screen` (node 25351:14722).
+ *
+ * The illustration slot is Core's own `PrizmaCaptureDigitalId` in its
+ * `tutorial` state — the Figma file names this exact instance "Capture /
+ * Digital ID" (node 26161:10686, Figma description: "Incode specific
+ * component for Digital ID module experience"), the same managed component
+ * already shipped as `core/platforms/web/src/CaptureDigitalId.tsx`. No module
+ * illustration is drawn here — the component owns its own tutorial artwork
+ * (`PrizmaIllustrationDigitalId`).
+ */
+export declare const DigitalIdUploadTutorialScreen: React.ForwardRefExoticComponent<DigitalIdUploadTutorialScreenProps & React.RefAttributes<HTMLDivElement>>;
+export default DigitalIdUploadTutorialScreen;

package/dist/DigitalIdUploadTutorialScreen.js

@@ -0,0 +1,23 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { PrizmaCaptureDigitalId } from '@incodetech/prizma-core-web/capture-digital-id';
+import { PrizmaTutorialScreen } from './TutorialScreen';
+import './ScreenLayout.css';
+/**
+ * Digital ID Upload — tutorial, built on the `PrizmaTutorialScreen` archetype
+ * (GUIDELINES.md §6-A). Figma: `Upload Digital ID` file
+ * (wxFsHRvllern4VnjRqM4JO), "Web Happy Path - Light Mode" section, `Tutorial
+ * Screen` (node 25351:14722).
+ *
+ * The illustration slot is Core's own `PrizmaCaptureDigitalId` in its
+ * `tutorial` state — the Figma file names this exact instance "Capture /
+ * Digital ID" (node 26161:10686, Figma description: "Incode specific
+ * component for Digital ID module experience"), the same managed component
+ * already shipped as `core/platforms/web/src/CaptureDigitalId.tsx`. No module
+ * illustration is drawn here — the component owns its own tutorial artwork
+ * (`PrizmaIllustrationDigitalId`).
+ */
+export const DigitalIdUploadTutorialScreen = forwardRef(({ strings, screenId = 'digital-id-upload-tutorial', overrides, onAction, ...shell }, ref) => (_jsx(PrizmaTutorialScreen, { ref: ref, title: strings.tutorial.title, subtitle: strings.tutorial.subtitle, ctaLabel: strings.tutorial.ctaLabel, illustration: _jsx(PrizmaCaptureDigitalId, { state: "tutorial" }), verifiedLabel: strings.verifiedLabel, navLabel: strings.navLabel, screenId: screenId, overrides: overrides, onAction: onAction, ...shell })));
+DigitalIdUploadTutorialScreen.displayName = 'DigitalIdUploadTutorialScreen';
+export default DigitalIdUploadTutorialScreen;

package/dist/DocumentCaptureIllustration.d.ts

@@ -6,7 +6,7 @@ import './DocumentCaptureLayout.css';
  *
  * WHY IT LIVES IN THE MODULE LAYER: `prizma-core-web` ships
  * `PrizmaIllustrationSelfie`, `…IdTutorial`, `…IdIntro`, `…IdFlip`,
- * `…IdHint`, `…IdFeedback`, `…NfcScan`, `…NfcIssue`, `…Geolocation`,
+ * `…IdHint`, `…IdFeedback`, `…NfcScan`, `…Geolocation`,
  * `…DigitalId` and `…Avatar` — there is NO document / proof-of-address
  * illustration. GUIDELINES.md §10 is the standing asset rule for that gap
  * ("Illustrations…: inline SVG React components (Figma-sourced), tintable via

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 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 declare const EkybCountryScreen: React.ForwardRefExoticComponent<EkybCountryScreenProps & React.RefAttributes<HTMLDivElement>>;
 export default EkybCountryScreen;