@incodetech/prizma-core-screens 0.1.0

package/dist/index.js

@@ -0,0 +1,130 @@
+// @incodetech/prizma-core-screens — barrel.
+//
+// Foundation: shell, nav, capture overlay, and the seven screen archetypes
+// (GUIDELINES.md §6). Per-module screens (face-capture, id-capture, …) land
+// per wave and are exported below the foundation block.
+export * from './types';
+export { PrizmaScreenShell } from './ScreenShell';
+export { PrizmaScreenNav } from './ScreenNav';
+export { PrizmaCaptureOverlay, } from './CaptureOverlay';
+export { PrizmaTutorialScreen } from './TutorialScreen';
+export { PrizmaCaptureScreen } from './CaptureScreen';
+export { PrizmaProcessingScreen, } from './ProcessingScreen';
+export { PrizmaResultScreen, } from './ResultScreen';
+export { PrizmaReviewScreen, } from './ReviewScreen';
+export { PrizmaListScreen, } from './ListScreen';
+export { PrizmaViewfinderScreen } from './ViewfinderScreen';
+export { PrizmaFormScreen } from './FormScreen';
+export { FaceCaptureTutorialScreen, } from './FaceCaptureTutorialScreen';
+export { FaceCaptureCapturingScreen, } from './FaceCaptureCapturingScreen';
+export { FaceCaptureManualCaptureScreen, } from './FaceCaptureManualCaptureScreen';
+export { FaceCaptureLoadingScreen, } from './FaceCaptureLoadingScreen';
+export { FaceCaptureResultSuccessScreen, } from './FaceCaptureResultSuccessScreen';
+export { FaceCaptureResultErrorScreen, } from './FaceCaptureResultErrorScreen';
+export { FaceCaptureNoConnectionScreen, } from './FaceCaptureNoConnectionScreen';
+export { FaceMatchComparisonScreen, } from './FaceMatchComparisonScreen';
+export { FaceMatchComparisonCompactScreen, } from './FaceMatchComparisonCompactScreen';
+export { FaceMatchResultScreen, } from './FaceMatchResultScreen';
+export { DocumentCaptureIllustration, } from './DocumentCaptureIllustration';
+export { DocumentCaptureTutorialScreen, } from './DocumentCaptureTutorialScreen';
+export { DocumentCaptureMethodSelectionScreen, } from './DocumentCaptureMethodSelectionScreen';
+export { DocumentCaptureCommonIssuesScreen, } from './DocumentCaptureCommonIssuesScreen';
+export { DocumentCaptureNextPageScreen, } from './DocumentCaptureNextPageScreen';
+export { DocumentCaptureCaptureScreen, } from './DocumentCaptureCaptureScreen';
+export { DocumentCaptureConfirmImageScreen, } from './DocumentCaptureConfirmImageScreen';
+export { DocumentCaptureConfirmUploadScreen, } from './DocumentCaptureConfirmUploadScreen';
+export { DocumentCaptureGenericErrorScreen, } from './DocumentCaptureGenericErrorScreen';
+export { DocumentCaptureNoConnectionScreen, } from './DocumentCaptureNoConnectionScreen';
+export { IdCaptureDocumentSelectionScreen, } from './IdCaptureDocumentSelectionScreen';
+export { IdCaptureAgeVerificationScreen, } from './IdCaptureAgeVerificationScreen';
+export { IdCaptureTutorialScreen, } from './IdCaptureTutorialScreen';
+export { IdCaptureStageScreen, } from './IdCaptureStageScreen';
+export { IdCaptureAnalyzingScreen, } from './IdCaptureAnalyzingScreen';
+export { IdCaptureResultScreen, } from './IdCaptureResultScreen';
+export { IdCaptureFlipScreen, } from './IdCaptureFlipScreen';
+export { IdCaptureCommonIssuesScreen, } from './IdCaptureCommonIssuesScreen';
+export { IdCapturePermissionScreen, } from './IdCapturePermissionScreen';
+export { IdCaptureDocumentErrorScreen, } from './IdCaptureDocumentErrorScreen';
+export { IdCaptureHoldOnScreen, } from './IdCaptureHoldOnScreen';
+export { IdCaptureNoConnectionScreen, } from './IdCaptureNoConnectionScreen';
+export { PhoneInputVerifyScreen, } from './PhoneInputVerifyScreen';
+export { PhoneInputOtpScreen } from './PhoneInputOtpScreen';
+export { PhoneInputSnaLoadingScreen, } from './PhoneInputSnaLoadingScreen';
+export { PhoneInputSuccessScreen, } from './PhoneInputSuccessScreen';
+export { PhoneInputErrorScreen, } from './PhoneInputErrorScreen';
+export { EmailInputVerifyScreen, } from './EmailInputVerifyScreen';
+export { EmailInputOtpScreen } from './EmailInputOtpScreen';
+export { EmailInputProcessingScreen, } from './EmailInputProcessingScreen';
+export { EmailInputSuccessScreen, } from './EmailInputSuccessScreen';
+export { EmailInputErrorScreen, } from './EmailInputErrorScreen';
+export { GeolocationIntroScreen, } from './GeolocationIntroScreen';
+export { GeolocationPermissionScreen, } from './GeolocationPermissionScreen';
+export { GeolocationBrowserStepsScreen, } from './GeolocationBrowserStepsScreen';
+export { GeolocationErrorScreen, } from './GeolocationErrorScreen';
+export { CurpEnterScreen } from './CurpEnterScreen';
+export { CurpGenerateScreen } from './CurpGenerateScreen';
+export { CurpConfirmScreen } from './CurpConfirmScreen';
+export { CurpProcessingScreen } from './CurpProcessingScreen';
+export { CurpResultScreen } from './CurpResultScreen';
+export { ElectronicSignatureDrawScreen } from './ElectronicSignatureDrawScreen';
+export { ElectronicSignatureErrorScreen } from './ElectronicSignatureErrorScreen';
+export { ElectronicSignatureReviewScreen } from './ElectronicSignatureReviewScreen';
+export { ElectronicSignatureSuccessScreen } from './ElectronicSignatureSuccessScreen';
+export { QualifiedSignatureAcceptScreen } from './QualifiedSignatureAcceptScreen';
+export { QualifiedSignatureDocumentScreen } from './QualifiedSignatureDocumentScreen';
+export { QualifiedSignatureProcessingScreen } from './QualifiedSignatureProcessingScreen';
+export { QualifiedSignatureResultScreen } from './QualifiedSignatureResultScreen';
+export { QualifiedSignatureReviewScreen } from './QualifiedSignatureReviewScreen';
+export { QualifiedSignatureUploadScreen } from './QualifiedSignatureUploadScreen';
+export { FormsChoiceScreen } from './FormsChoiceScreen';
+export { FormsErrorScreen } from './FormsErrorScreen';
+export { FormsFieldScreen } from './FormsFieldScreen';
+export { FormsLongFormScreen } from './FormsLongFormScreen';
+export { FormsSuccessScreen } from './FormsSuccessScreen';
+export { DataSharingConsentConsentScreen } from './DataSharingConsentConsentScreen';
+export { EkycDetailsScreen } from './EkycDetailsScreen';
+export { EkycErrorScreen } from './EkycErrorScreen';
+export { EkycLicenseScreen } from './EkycLicenseScreen';
+export { EkycProcessingScreen } from './EkycProcessingScreen';
+export { EkycSuccessScreen } from './EkycSuccessScreen';
+export { EkybAddressDetailsScreen } from './EkybAddressDetailsScreen';
+export { EkybBusinessDetailsScreen } from './EkybBusinessDetailsScreen';
+export { EkybCountryScreen } from './EkybCountryScreen';
+export { EkybErrorScreen } from './EkybErrorScreen';
+export { EkybOwnersScreen } from './EkybOwnersScreen';
+export { EkybProcessingScreen } from './EkybProcessingScreen';
+export { EkybSuccessScreen } from './EkybSuccessScreen';
+export { WatchlistBusinessFormScreen } from './WatchlistBusinessFormScreen';
+export { WatchlistBusinessProcessingScreen } from './WatchlistBusinessProcessingScreen';
+export { WatchlistBusinessSuccessScreen } from './WatchlistBusinessSuccessScreen';
+export { VideoSelfieCameraStepsScreen } from './VideoSelfieCameraStepsScreen';
+export { VideoSelfieErrorScreen, } from './VideoSelfieErrorScreen';
+export { VideoSelfieFlipCameraScreen } from './VideoSelfieFlipCameraScreen';
+export { VideoSelfieFlipIdScreen } from './VideoSelfieFlipIdScreen';
+export { VideoSelfieIdCaptureScreen, } from './VideoSelfieIdCaptureScreen';
+export { VideoSelfiePermissionRequiredScreen } from './VideoSelfiePermissionRequiredScreen';
+export { VideoSelfiePermissionScreen } from './VideoSelfiePermissionScreen';
+export { VideoSelfieProcessingScreen } from './VideoSelfieProcessingScreen';
+export { VideoSelfieRetryScreen } from './VideoSelfieRetryScreen';
+export { VideoSelfieSelfieCaptureScreen, } from './VideoSelfieSelfieCaptureScreen';
+export { VideoSelfieSpeakScreen, } from './VideoSelfieSpeakScreen';
+export { VideoSelfieSuccessScreen } from './VideoSelfieSuccessScreen';
+export { VideoSelfieTutorialScreen } from './VideoSelfieTutorialScreen';
+export { NfcCommonIssuesScreen } from './NfcCommonIssuesScreen';
+export { NfcErrorScreen, } from './NfcErrorScreen';
+export { NfcProcessingScreen } from './NfcProcessingScreen';
+export { NfcScanningScreen, } from './NfcScanningScreen';
+export { NfcSettingsScreen } from './NfcSettingsScreen';
+export { NfcSuccessScreen } from './NfcSuccessScreen';
+export { NfcSymbolScreen } from './NfcSymbolScreen';
+export { NfcTryAgainScreen, } from './NfcTryAgainScreen';
+export { NfcTutorialScreen } from './NfcTutorialScreen';
+export { PermissionsRequiredScreen, } from './PermissionsRequiredScreen';
+export { PermissionsAllowScreen, } from './PermissionsAllowScreen';
+export { PermissionsBrowserStepsScreen, } from './PermissionsBrowserStepsScreen';
+export { LoaderScreen } from './LoaderScreen';
+export { ErrorScreensScreen } from './ErrorScreensScreen';
+export { DemoScreensEndScreen, } from './DemoScreensEndScreen';
+// ── Flows (module screen sequences — powers the FlowPlayer prototypes) ──────
+export { faceCaptureFlow, faceCaptureBranches, faceMatchFlow, faceMatchBranches, } from './flows';
+export { documentCaptureFlow, documentCaptureCameraFlow, documentCaptureUploadFlow, documentCaptureBranchesByMethod, documentCaptureBranches, idCaptureFlow, idCapturePassportFlow, idCaptureBranches, idCaptureVerticalOf, } from './flows';

package/dist/styles.css

@@ -0,0 +1,33 @@
+/* Aggregate stylesheet for @incodetech/prizma-core-screens.
+ *
+ * GENERATED — do not edit by hand. Source of truth: scripts/exports-map.mjs
+ * (buildStylesCss). `npm run build` regenerates and drift-checks this file.
+ *
+ * One @import per src/*.css component sheet. Consumers who want every Prizma
+ * component style import this once:
+ *   @import '@incodetech/prizma-core-screens/styles.css';
+ * Consumers who want only the styles they use import per-component instead:
+ *   @import '@incodetech/prizma-core-screens/button.css';
+ *
+ * Tokens are NOT imported here — the consumer owns that, once:
+ *   @import '@incodetech/prizma-core-tokens/css';
+ */
+@import './CaptureOverlay.css';
+@import './CurpLayout.css';
+@import './DataSharingConsentLayout.css';
+@import './DocumentCaptureLayout.css';
+@import './EkycLayout.css';
+@import './ElectronicSignatureLayout.css';
+@import './FaceCaptureLayout.css';
+@import './FaceMatchLayout.css';
+@import './FormScreen.css';
+@import './FormsLayout.css';
+@import './IdCaptureLayout.css';
+@import './NfcLayout.css';
+@import './PhoneInputLayout.css';
+@import './QualifiedSignatureLayout.css';
+@import './ScreenLayout.css';
+@import './ScreenNav.css';
+@import './ScreenShell.css';
+@import './VideoSelfieLayout.css';
+@import './ViewfinderScreen.css';

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+import type { ReactNode } from 'react';
+/**
+ * An interaction a screen can emit. `cta` advances the flow; `auto` is fired
+ * by timed states (capturing / uploading) when the host enables simulation.
+ *
+ * `tertiary` exists because a screen can offer TWO non-primary actions at once:
+ * Phone Input's OTP sections draw "Didn't receive the code? **Resend code** or
+ * **Change phone number**" — two different flows (re-send the SMS vs go back to
+ * phone entry) that a host must be able to tell apart. With only `secondary`
+ * they collapsed into one indistinguishable event. DEVIATIONS #PI-10.
+ */
+export interface PrizmaScreenAction {
+    type: 'cta' | 'secondary' | 'tertiary' | 'auto' | 'help';
+    /** Stable per-screen identifier, e.g. `face-capture-tutorial`. */
+    screenId?: string;
+}
+/** Sanctioned host overrides — the ONLY customization surface besides the
+ *  theme seed. Kept deliberately narrow (THEMING-CONTRACT addendum): Core
+ *  geometry/typography stay non-themeable; these map to Incode Studio's
+ *  customer controls. */
+export interface PrizmaScreenOverrides {
+    /** Content alignment for title blocks / hint rows. Default `'centered'`.
+     *  NOTE: Core `PrizmaTitle` supports `centered | left` only — `right` is a
+     *  logged deviation (DEVIATIONS.md) and falls back to `left`. */
+    align?: 'centered' | 'left';
+    /** Replaces the default Incode wordmark in the screen nav (e.g. an <img>
+     *  of the client logo, rendered `object-fit: contain`, never stretched). */
+    logo?: ReactNode;
+}
+export type PrizmaScreenActionHandler = (action: PrizmaScreenAction) => void;
+/**
+ * Header and footer are SEPARATE, independently-controlled components — never
+ * one on/off toggle (owner rule 2026-08-18).
+ *
+ * Defaults differ by screen family:
+ *  - **Non-capture** screens (tutorial, form, processing, result): header AND
+ *    footer both shown.
+ *  - **Capture** screens (Face Capture, Video Selfie, ID Capture, Document
+ *    Capture): **footer only, no logo**. Capture screens are already dense —
+ *    live feedback, help icon, title/subtitle, encrypted tag — and the space is
+ *    reserved for what is coming (flashlight, hologram feedback, accepted
+ *    documents).
+ *
+ * Client customization on capture screens is additive: passing
+ * `overrides.logo` IS the opt-in, so the logo appears alongside the default
+ * footer. `showHeader` still wins when set explicitly.
+ */
+export interface PrizmaScreenChromeProps {
+    /** Render the header (client logo). Non-capture screens default `true`;
+     *  capture screens default to `Boolean(overrides.logo)` — i.e. off unless the
+     *  client opts in by supplying a logo. */
+    showHeader?: boolean;
+    /** Render the "verified by Incode" footer. Defaults `true` everywhere the
+     *  module's Figma section has one. */
+    showFooter?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,8 @@
+// Shared contracts for @incodetech/prizma-core-screens.
+//
+// Screens are pure presentational components: copy arrives via props (no
+// baked-in English — same i18n rule as prizma-core-web), brand theming comes
+// from `applyPrizmaTheme` (prizma-core-web), dark mode from
+// `[data-prizma-theme='dark']`. `onAction` is the single interaction hook —
+// it powers the FlowPlayer prototypes without any per-screen wiring.
+export {};