@smileid/usesmileid 12.0.0-beta01 → 12.0.0

package/dist/presentation/flow/dsl/builder/screens_builder.js

@@ -3,44 +3,98 @@ import { DocumentCaptureMode } from "../../../../core/models/document_capture_mo
 export { CaptureType };
 // --- Per-screen builders ---------------------------------------------------
 export class ConsentConfigBuilder {
+    /** Your company name, shown in the consent copy. */
     partnerName = "";
-    /** Partner brand mark rendered next to the Smile ID icon at the top of the consent screen. */
+    /**
+     * Optional partner logo shown on the consent screen, rendered next to
+     * the Smile ID icon at the top.
+     */
     partnerIcon;
+    /** URL of your privacy policy, linked from the consent screen. */
     partnerPrivacyPolicyUrl;
+    /**
+     * Whether to show the "Powered by Smile ID" attribution. Defaults to
+     * true.
+     */
     showAttribution = true;
+    /**
+     * Callback invoked with the `ConsentInformation` when the user grants
+     * consent.
+     */
     onConsentGranted;
+    /** Provides a custom allow/agree button in place of the default. */
     allowButton;
+    /** Provides a custom deny/cancel button in place of the default. */
     denyButton;
 }
 export class InstructionsConfigBuilder {
-    /** Leading title text (title-text colour). Defaults to the localized prefix. */
+    /**
+     * The leading, non-emphasized part of the instructions screen title.
+     * Defaults to the localized prefix.
+     */
     titlePrefix;
-    /** Emphasized word (primary colour, own line). Defaults to the localized "selfie". */
+    /**
+     * The emphasized (highlighted) part of the instructions screen title.
+     * Defaults to the localized "selfie".
+     */
     titleEmphasis;
-    /** Lottie hero. Unset uses the selfie hero (or the ESS hero when enhanced liveness is on). */
+    /**
+     * Name of the hero animation asset shown at the top of the
+     * instructions screen. Unset uses the selfie hero (or the ESS hero
+     * when enhanced liveness is on).
+     */
     heroAnimation;
-    /** Capture-guidelines section title (rendered uppercase). */
+    /** Heading for the list of capture guidelines (rendered uppercase). */
     guidelinesSectionTitle;
-    /** Capture-guideline tiles; push to customize. Empty uses the defaults. */
+    /** The list of guideline items shown to the user. Empty uses the defaults. */
     guidelines = [];
+    /**
+     * Whether to show the "Powered by Smile ID" attribution. Defaults to
+     * true.
+     */
     showAttribution = true;
-    /** Draw the face-oval ring around the hero animation. */
+    /** When true, draws the face-oval ring around the hero animation. */
     showHeroOval = true;
+    /** Provides a custom continue button in place of the default. */
     continueButton;
 }
 export class SelfieCaptureConfigBuilder {
+    /**
+     * When true, lets an assisting agent flip to the rear camera to capture
+     * the subject. Defaults to false.
+     */
     allowAgentMode = false;
+    /**
+     * When true, uses the enhanced active-liveness capture path. Defaults
+     * to false.
+     */
     enableEnhancedLiveness = false;
 }
 export class DocumentCaptureConfigBuilder {
-    /** The document being captured. **Required** — missing it fails validation. */
+    /**
+     * The kind of document being captured, which drives the capture
+     * framing and aspect ratio. **Required** — missing it fails validation.
+     */
     documentType;
-    /** When the photo is taken. Defaults to auto-capture with a 10s manual fallback. */
+    /**
+     * Whether the document is captured automatically when held steady, or
+     * manually by shutter. Defaults to auto-capture with a 10s manual
+     * fallback.
+     */
     captureMode = DocumentCaptureMode.AutoCaptureWithManualFallback();
+    /**
+     * When true, lets the user pick an existing document image from the
+     * gallery. Defaults to false.
+     */
     allowGalleryUpload = false;
+    /** When true, captures both the front and back of the document. Defaults to true. */
     captureBothSides = true;
+    /** When true, lets the user skip capturing the back side. Defaults to false. */
     allowSkipBack = false;
-    /** Optional aspect ratio hint — e.g. CR-80 ID card = 1.586. */
+    /**
+     * Optional fixed aspect ratio for the document frame when the ID's
+     * dimensions are known in advance — e.g. CR-80 ID card = 1.586.
+     */
     knownIdAspectRatio;
     /** The `documentType`'s aspect ratio when present, otherwise `knownIdAspectRatio`. */
     get resolvedAspectRatio() {
@@ -48,15 +102,25 @@ export class DocumentCaptureConfigBuilder {
     }
 }
 export class CaptureConfigBuilder {
+    /** What this screen captures — a selfie or a document. Required. */
     captureType;
+    /** Provides a custom start/capture button in place of the default. */
     startButton;
     _selfie;
     _document;
+    /**
+     * Configures selfie-specific capture options (agent mode, enhanced
+     * liveness).
+     */
     selfie(block) {
         if (!this._selfie)
             this._selfie = new SelfieCaptureConfigBuilder();
         block(this._selfie);
     }
+    /**
+     * Configures document-specific capture options (document type, capture
+     * mode, gallery upload, two-sided capture).
+     */
     document(block) {
         if (!this._document)
             this._document = new DocumentCaptureConfigBuilder();
@@ -72,41 +136,78 @@ export class CaptureConfigBuilder {
     }
 }
 export class PreviewConfigBuilder {
+    /** Whether the preview screen offers a retake action. */
     allowRetake = true;
+    /**
+     * Whether to show the "Powered by Smile ID" attribution. Defaults to
+     * true.
+     */
     showAttribution = true;
+    /** Provides a custom continue button in place of the default. */
     continueButton;
+    /** Provides a custom cancel button in place of the default. */
     cancelButton;
 }
 export class ProcessingConfigBuilder {
+    /**
+     * When true, shows a numeric progress percentage while the job is
+     * processing.
+     */
     showProgressPercentage = true;
+    /**
+     * Whether to show the "Powered by Smile ID" attribution. Defaults to
+     * true.
+     */
     showAttribution = true;
+    /** Provides a custom continue button in place of the default. */
     continueButton;
+    /** Provides a custom retry button in place of the default. */
     retryButton;
+    /** Provides a custom exit button in place of the default. */
     exitButton;
 }
 // --- Top-level screens builder ---------------------------------------------
 export class ScreensBuilder {
     _steps = [];
+    /**
+     * Adds a consent screen that collects the user's agreement to
+     * biometric data processing before capture.
+     */
     consent(block) {
         const config = new ConsentConfigBuilder();
         block?.(config);
         this._steps.push({ kind: "consent", config });
     }
+    /**
+     * Adds an instructions screen explaining what the user is about to do.
+     */
     instructions(block) {
         const config = new InstructionsConfigBuilder();
         block?.(config);
         this._steps.push({ kind: "instructions", config });
     }
+    /**
+     * Adds a capture screen that runs the camera and on-device detection
+     * for a selfie or document.
+     */
     capture(block) {
         const config = new CaptureConfigBuilder();
         block(config);
         this._steps.push({ kind: "capture", config });
     }
+    /**
+     * Adds a preview screen that lets the user review the captured image
+     * and optionally retake it.
+     */
     preview(block) {
         const config = new PreviewConfigBuilder();
         block?.(config);
         this._steps.push({ kind: "preview", config });
     }
+    /**
+     * Adds a processing screen shown while the job is submitted, displaying
+     * success, failure, or retry states.
+     */
     processing(block) {
         const config = new ProcessingConfigBuilder();
         block?.(config);

package/dist/presentation/flow/dsl/builder/screens_builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"screens_builder.js","sourceRoot":"","sources":["../../../../../src/presentation/flow/dsl/builder/screens_builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"screens_builder.js","sourceRoot":"","sources":["../../../../../src/presentation/flow/dsl/builder/screens_builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAKpF,OAAO,EAAE,WAAW,EAAE,CAAC;AAqBvB,8EAA8E;AAE9E,MAAM,OAAO,oBAAoB;IAC/B,oDAAoD;IACpD,WAAW,GAAG,EAAE,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAa;IACxB,kEAAkE;IAClE,uBAAuB,CAAU;IACjC;;;OAGG;IACH,eAAe,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,gBAAgB,CAAsC;IACtD,oEAAoE;IACpE,WAAW,CAAc;IACzB,oEAAoE;IACpE,UAAU,CAAc;CACzB;AAED,MAAM,OAAO,yBAAyB;IACpC;;;OAGG;IACH,WAAW,CAAU;IACrB;;;OAGG;IACH,aAAa,CAAU;IACvB;;;;OAIG;IACH,aAAa,CAAuB;IACpC,uEAAuE;IACvE,sBAAsB,CAAU;IAChC,8EAA8E;IAC9E,UAAU,GAA2B,EAAE,CAAC;IACxC;;;OAGG;IACH,eAAe,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,YAAY,GAAG,IAAI,CAAC;IACpB,iEAAiE;IACjE,cAAc,CAAc;CAC7B;AAED,MAAM,OAAO,0BAA0B;IACrC;;;OAGG;IACH,cAAc,GAAG,KAAK,CAAC;IACvB;;;OAGG;IACH,sBAAsB,GAAG,KAAK,CAAC;CAChC;AAED,MAAM,OAAO,4BAA4B;IACvC;;;OAGG;IACH,YAAY,CAAgB;IAC5B;;;;OAIG;IACH,WAAW,GACT,mBAAmB,CAAC,6BAA6B,EAAE,CAAC;IACtD;;;OAGG;IACH,kBAAkB,GAAG,KAAK,CAAC;IAC3B,qFAAqF;IACrF,gBAAgB,GAAG,IAAI,CAAC;IACxB,gFAAgF;IAChF,aAAa,GAAG,KAAK,CAAC;IACtB;;;OAGG;IACH,kBAAkB,CAAU;IAE5B,sFAAsF;IACtF,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,YAAY,EAAE,gBAAgB,IAAI,IAAI,CAAC,kBAAkB,CAAC;IACxE,CAAC;CACF;AAED,MAAM,OAAO,oBAAoB;IAC/B,oEAAoE;IACpE,WAAW,CAAe;IAC1B,sEAAsE;IACtE,WAAW,CAAc;IAEjB,OAAO,CAA8B;IACrC,SAAS,CAAgC;IAEjD;;;OAGG;IACH,MAAM,CAAC,KAA8C;QACnD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,0BAA0B,EAAE,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAgD;QACvD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,4BAA4B,EAAE,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,mDAAmD;IACnD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,mDAAmD;IACnD,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAED,MAAM,OAAO,oBAAoB;IAC/B,yDAAyD;IACzD,WAAW,GAAG,IAAI,CAAC;IACnB;;;OAGG;IACH,eAAe,GAAG,IAAI,CAAC;IACvB,iEAAiE;IACjE,cAAc,CAAc;IAC5B,+DAA+D;IAC/D,YAAY,CAAc;CAC3B;AAED,MAAM,OAAO,uBAAuB;IAClC;;;OAGG;IACH,sBAAsB,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,eAAe,GAAG,IAAI,CAAC;IACvB,iEAAiE;IACjE,cAAc,CAAc;IAC5B,8DAA8D;IAC9D,WAAW,CAAc;IACzB,6DAA6D;IAC7D,UAAU,CAAc;CACzB;AAkBD,8EAA8E;AAE9E,MAAM,OAAO,cAAc;IACjB,MAAM,GAAiB,EAAE,CAAC;IAElC;;;OAGG;IACH,OAAO,CAAC,KAAyC;QAC/C,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAA8C;QACzD,MAAM,MAAM,GAAG,IAAI,yBAAyB,EAAE,CAAC;QAC/C,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAwC;QAC9C,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAyC;QAC/C,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAA4C;QACrD,MAAM,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAC7C,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/presentation/flow/dsl/builder/theme_builder.d.ts

@@ -17,17 +17,30 @@ export type ThemeConfiguration = {
  * picks light or dark at mount time based on the active color scheme.
  */
 export declare class ThemeConfigBuilder {
+    /** Primary brand color used for key actions and accents. */
     primaryColor?: AdaptiveColor;
+    /**
+     * Foreground color used on top of the primary color (for example
+     * button text).
+     */
     primaryForeground?: AdaptiveColor;
+    /** Secondary color used for less prominent surfaces and actions. */
     secondaryColor?: AdaptiveColor;
+    /** Accent color used for highlights and selected states. */
     accentColor?: AdaptiveColor;
+    /** Optional font family applied to all SDK text. */
     fontFamily?: string;
+    /** Corner radius applied to buttons. */
     buttonShape?: number;
+    /** Corner radius applied to cards and surfaces. */
     cardShape?: number;
-    /** Helper to create an `AdaptiveColor` with explicit light/dark values. */
+    /**
+     * Builds an adaptive color that resolves to the light or dark value
+     * based on the active appearance.
+     */
     color(light: string, dark: string): AdaptiveColor;
     /**
-     * Helper to create a button/card shape value. Returns the input
+     * Builds a corner-shape value from the given radius. Returns the input
      * radius unchanged — React Native resolves shape at render time via
      * `borderRadius`, so the `buttonShape` / `cardShape` properties are
      * plain numbers.

package/dist/presentation/flow/dsl/builder/theme_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme_builder.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/flow/dsl/builder/theme_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2EAA2E;IAC3E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa;IAIjD;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI7B;;;;OAIG;IACH,KAAK,IAAI,kBAAkB;IAO3B,OAAO,CAAC,QAAQ;CAmCjB"}
+{"version":3,"file":"theme_builder.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/flow/dsl/builder/theme_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAElC,oEAAoE;IACpE,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa;IAIjD;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI7B;;;;OAIG;IACH,KAAK,IAAI,kBAAkB;IAO3B,OAAO,CAAC,QAAQ;CAmCjB"}

package/dist/presentation/flow/dsl/builder/theme_builder.js

@@ -7,19 +7,32 @@ import { DEFAULT_FONT_FAMILY, defaultDarkTheme, defaultLightTheme, typographyWit
  * picks light or dark at mount time based on the active color scheme.
  */
 export class ThemeConfigBuilder {
+    /** Primary brand color used for key actions and accents. */
     primaryColor;
+    /**
+     * Foreground color used on top of the primary color (for example
+     * button text).
+     */
     primaryForeground;
+    /** Secondary color used for less prominent surfaces and actions. */
     secondaryColor;
+    /** Accent color used for highlights and selected states. */
     accentColor;
+    /** Optional font family applied to all SDK text. */
     fontFamily;
+    /** Corner radius applied to buttons. */
     buttonShape;
+    /** Corner radius applied to cards and surfaces. */
     cardShape;
-    /** Helper to create an `AdaptiveColor` with explicit light/dark values. */
+    /**
+     * Builds an adaptive color that resolves to the light or dark value
+     * based on the active appearance.
+     */
     color(light, dark) {
         return Object.freeze({ light, dark });
     }
     /**
-     * Helper to create a button/card shape value. Returns the input
+     * Builds a corner-shape value from the given radius. Returns the input
      * radius unchanged — React Native resolves shape at render time via
      * `borderRadius`, so the `buttonShape` / `cardShape` properties are
      * plain numbers.

package/dist/presentation/flow/dsl/builder/theme_builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme_builder.js","sourceRoot":"","sources":["../../../../../src/presentation/flow/dsl/builder/theme_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,GAGzB,MAAM,sBAAsB,CAAC;AAc9B;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,YAAY,CAAiB;IAC7B,iBAAiB,CAAiB;IAClC,cAAc,CAAiB;IAC/B,WAAW,CAAiB;IAE5B,UAAU,CAAU;IAEpB,WAAW,CAAU;IACrB,SAAS,CAAU;IAEnB,2EAA2E;IAC3E,KAAK,CAAC,KAAa,EAAE,IAAY;QAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAc;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;YAChD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ,CACd,OAAyB,EACzB,IAAqB;QAErB,MAAM,IAAI,GAAG,CAAC,CAA4B,EAAsB,EAAE,CAChE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3C,uEAAuE;QACvE,oEAAoE;QACpE,uEAAuE;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,cAAc,GAA8B;YAChD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,IAAI;YACP,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,cAAc,EAAE;YAC7C,UAAU,EAAE,wBAAwB,CAClC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,UAAU,IAAI,mBAAmB,CACvC;YACD,MAAM,EAAE;gBACN,GAAG,IAAI,CAAC,MAAM;gBACd,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE;oBACpC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxE;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"theme_builder.js","sourceRoot":"","sources":["../../../../../src/presentation/flow/dsl/builder/theme_builder.ts"],"names":[],"mappings":"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"}

package/dist/presentation/flow/dsl/use_smile_id_builder.d.ts

@@ -1,10 +1,12 @@
 import { UseSmileIDFlowBuilder } from "./use_smile_id_flow_builder";
 import type { FlowBuildResult } from "./flow_build_result";
 /**
- * Top-level partner entry point. Configures the flow declaratively
- * via the `builder` closure, then renders the result. The component
- * owns the build-and-dispatch lifecycle internally — partners never
- * touch the intermediate [FlowBuildResult].
+ * Entry point for a UseSmileID identity-verification flow. Host this in
+ * your UI and configure the flow inside the builder closure — declare
+ * the screens, network credentials, theme, and ML analyzers, then handle
+ * the terminal outcome via `onResult`. The component owns the
+ * build-and-dispatch lifecycle internally — partners never touch the
+ * intermediate [FlowBuildResult].
  *
  *     export function VerifyScreen({ onComplete }) {
  *       return (

package/dist/presentation/flow/dsl/use_smile_id_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_builder.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_builder.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,sBAAsB,+BAwCpE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAClD,eAAe,CAIjB;AAED,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"use_smile_id_builder.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_builder.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,sBAAsB,+BAwCpE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAClD,eAAe,CAIjB;AAED,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/presentation/flow/dsl/use_smile_id_builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_builder.js","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_builder.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AAgDrC,MAAM,UAAU,iBAAiB,CAAC,EAAE,OAAO,EAA0B;IACnE,2DAA2D;IAC3D,6DAA6D;IAC7D,gBAAgB;IAChB,EAAE;IACF,mEAAmE;IACnE,oEAAoE;IACpE,gEAAgE;IAChE,mEAAmE;IACnE,gEAAgE;IAChE,iEAAiE;IACjE,mDAAmD;IACnD,uDAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3C,MAAM,WAAW,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAChD,OAAO,CAAC,WAAW,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO;YACL,MAAM,EAAE,KAAK;YACb,WAAW,EAAE;gBACX,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,eAAe,EAEX,WAGD,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,eAAe,KAAK,IAAI;aAC9C;SACF,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CACL,KAAC,qBAAqB,IACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAC9B,eAAe,EAAE,WAAW,CAAC,eAAe,GAC5C,CACH,CAAC;IACJ,CAAC;IACD,OAAO,KAAC,mBAAmB,IAAC,aAAa,EAAE,MAAM,CAAC,aAAa,GAAI,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAmD;IAEnD,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC5C,SAAS,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"use_smile_id_builder.js","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_builder.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AAkDrC,MAAM,UAAU,iBAAiB,CAAC,EAAE,OAAO,EAA0B;IACnE,2DAA2D;IAC3D,6DAA6D;IAC7D,gBAAgB;IAChB,EAAE;IACF,mEAAmE;IACnE,oEAAoE;IACpE,gEAAgE;IAChE,mEAAmE;IACnE,gEAAgE;IAChE,iEAAiE;IACjE,mDAAmD;IACnD,uDAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3C,MAAM,WAAW,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAChD,OAAO,CAAC,WAAW,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO;YACL,MAAM,EAAE,KAAK;YACb,WAAW,EAAE;gBACX,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,eAAe,EAEX,WAGD,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,eAAe,KAAK,IAAI;aAC9C;SACF,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CACL,KAAC,qBAAqB,IACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAC9B,eAAe,EAAE,WAAW,CAAC,eAAe,GAC5C,CACH,CAAC;IACJ,CAAC;IACD,OAAO,KAAC,mBAAmB,IAAC,aAAa,EAAE,MAAM,CAAC,aAAa,GAAI,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAmD;IAEnD,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC5C,SAAS,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC"}

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.d.ts

@@ -70,18 +70,18 @@ export declare class UseSmileIDFlowBuilder {
      */
     localizations?: UseSmileIDLocalizations;
     /**
-     * Notified when the flow completes (success or failure). Defaults
-     * to a no-op so partners who don't need result handling still get
-     * a valid configuration; in production set this to wire the
-     * server-issued `JobSubmissionResponse` (`userId` / `jobId` /
-     * `status` / `message` / `createdAt`) into the partner's job-status
-     * pipeline.
+     * Invoked once when the flow terminates — with the submitted job on
+     * success, a typed error on failure, or a cancellation when the user
+     * exits before completing. Wire the returned user id / job id into
+     * your job-status pipeline. Defaults to a no-op so partners who don't
+     * need result handling still get a valid configuration; the
+     * server-issued `JobSubmissionResponse` carries `userId` / `jobId` /
+     * `status` / `message` / `createdAt`.
      */
     onResult: (result: UseSmileIDResult<JobSubmissionResponse>) => void;
     /**
-     * Optional. Notified for each analytics event during the flow.
-     * Stub note: orchestrator does not yet emit events — see
-     * `docs/Architecture.md § Rollout`.
+     * Invoked for every analytics event the SDK emits during the flow.
+     * Optional — leave unset to ignore analytics.
      */
     onAnalyticsEvent?: (event: UseSmileIDAnalyticsEvent) => void;
     private _config?;
@@ -90,15 +90,19 @@ export declare class UseSmileIDFlowBuilder {
     private _ml?;
     private _screens?;
     /**
-     * `b.config((c) => { c.enableCrashReporting = false; })`
+     * Configures global SDK feature flags (debug mode, offline mode, crash
+     * reporting). Repeated calls compose against the same configuration —
+     * `enableCrashReporting` set in one call and `enableDebugMode` set in
+     * another both end up on the final config.
      *
-     * Compose-friendly: repeated calls reuse the same builder, so
-     * `enableCrashReporting` set in one call and `enableDebugMode` set
-     * in another both end up on the final config.
+     * `b.config((c) => { c.enableCrashReporting = false; })`
      */
     config(block: (c: UseSmileIDConfigBuilder) => void): void;
     /**
-     * `b.theme((t) => { t.primaryColor = '#1A73E8'; t.buttonShape = 12; })`
+     * Configures the visual theme — colors, fonts, and corner shapes —
+     * applied to every SDK screen in the flow.
+     *
+     * `b.theme((t) => { t.primaryColor = t.color('#1A73E8', '#4DA3FF'); t.buttonShape = 12; })`
      *
      * Each call replaces the prior theme builder — partners typically
      * configure the theme in one place, and accumulating across helpers
@@ -107,6 +111,10 @@ export declare class UseSmileIDFlowBuilder {
      */
     theme(block: (t: ThemeConfigBuilder) => void): void;
     /**
+     * Configures the network stack: partner credentials, job type,
+     * timeouts, retry policy, response cache, and custom interceptors.
+     * Required for any flow that submits a job.
+     *
      * `b.network((n) => { n.config((c) => { c.partnerConfig((p) => { p.partnerId = ...; }); }); })`
      *
      * Each call replaces the prior network builder. Network config
@@ -115,10 +123,17 @@ export declare class UseSmileIDFlowBuilder {
      */
     network(block: (n: UseSmileIDNetworkBuilder) => void): void;
     /**
+     * Registers the on-device ML analyzers used for face and document
+     * detection, keyed by capture type.
+     *
      * `b.ml((m) => { m.analyzers((a) => { a.forCaptureType(CaptureType.selfie, (face) => face.add(useSmileIDVisionFace)); }); })`
      */
     ml(block: (m: UseSmileIDMLBuilder) => void): void;
     /**
+     * Declares the ordered sequence of screens the flow presents. Screens
+     * render in the order they are added; the same screen type may be
+     * added more than once.
+     *
      * `b.screens((screens) => { screens.instructions(); screens.capture((c) => { c.captureType = CaptureType.selfie; }); })`
      *
      * Each screen-builder call appends a step to the orchestrator's
@@ -126,10 +141,11 @@ export declare class UseSmileIDFlowBuilder {
      */
     screens(block: (s: ScreensBuilder) => void): void;
     /**
-     * Quick triage of the in-progress builder state. Today the only
-     * rule it surfaces is the empty-screens-block error — `b.screens`
-     * must register at least one screen before the builder can produce
-     * a flow.
+     * Runs a pre-flight check of the current builder configuration and
+     * returns a `ValidationState` describing any blocking issues, without
+     * throwing. Today the only rule it surfaces is the empty-screens-block
+     * error — `b.screens` must register at least one screen before the
+     * builder can produce a flow.
      *
      * The full rule set (screen ordering, dependency rules, KYC and
      * consent payload validation, etc.) runs inside `build()` and is
@@ -137,38 +153,48 @@ export declare class UseSmileIDFlowBuilder {
      * the full picture during configuration should call
      * `useSmileIDBuilder(...)` and pattern-match on the returned
      * `result.kind`.
+     *
+     * @returns a `ValidationState` describing any blocking issues.
      */
     validate(): ValidationState;
     /**
-     * Validate a `ConsentInformation` payload in isolation — useful
-     * when the source of truth is dynamic (e.g. a payload pulled from
-     * partner storage or a remote config) and the partner wants to
-     * pre-flight it before assigning to `b.consentInformation`.
+     * Validates a `ConsentInformation` payload in isolation and returns a
+     * `ValidationState`, without throwing. Useful when the payload comes
+     * from dynamic partner storage or remote config — pre-flight it before
+     * assigning to `b.consentInformation`.
      */
     validateConsent(consent: ConsentInformation): ValidationState;
     /**
-     * Validate an `EnhancedKYCParams` payload in isolation — useful
-     * when the partner pulls KYC fields from a form or remote config
-     * and wants to pre-flight them before assigning to
-     * `b.enhancedKYCParams`.
+     * Validates an `EnhancedKYCParams` payload in isolation and returns a
+     * `ValidationState`, without throwing. Useful when the partner pulls
+     * KYC fields from a form or remote config and wants to pre-flight them
+     * before assigning to `b.enhancedKYCParams`.
      */
     validateEnhancedKYCParams(params: EnhancedKYCParams): ValidationState;
     /**
-     * Validate a `BiometricKYCParams` payload in isolation. Same
-     * semantics as `validateEnhancedKYCParams` — same field rules,
-     * different param shape.
+     * Validates a `BiometricKYCParams` payload in isolation and returns a
+     * `ValidationState`, without throwing.
      */
     validateBiometricKYCParams(params: BiometricKYCParams): ValidationState;
-    /** Validate a `DocumentVerificationParams` payload in isolation. */
+    /**
+     * Validates a `DocumentVerificationParams` payload in isolation and
+     * returns a `ValidationState`, without throwing. Only `country` is
+     * required; `idType` is optional.
+     */
     validateDocumentVerificationParams(params: DocumentVerificationParams): ValidationState;
-    /** Validate an `EnhancedDocumentVerificationParams` payload in isolation. */
+    /**
+     * Validates an `EnhancedDocumentVerificationParams` payload in
+     * isolation and returns a `ValidationState`, without throwing. Both
+     * `country` and `idType` are required.
+     */
     validateEnhancedDocumentVerificationParams(params: EnhancedDocumentVerificationParams): ValidationState;
     /**
-     * Validate a `UserDetails` payload in isolation — useful when the
-     * partner pulls user PII from a form or remote config and wants to
-     * pre-flight it before assigning to `b.userDetails`. Surfaces the
-     * same dotted-path field names (`userDetails.givenNames` etc.) that
-     * the in-build validator emits.
+     * Validates a `UserDetails` payload in isolation and returns a
+     * `ValidationState`, without throwing. Useful when the partner pulls
+     * user PII from a form or remote config and wants to pre-flight it
+     * before assigning to `b.userDetails`. Surfaces the same dotted-path
+     * field names (`userDetails.givenNames` etc.) that the in-build
+     * validator emits.
      */
     validateUserDetails(userDetails: UserDetails): ValidationState;
     /**

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_flow_builder.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_flow_builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use_smile_id_flow_builder.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_flow_builder.ts"],"names":[],"mappings":"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"}