@smileid/usesmileid 12.0.0-beta01

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

@@ -0,0 +1,163 @@
+import { ScanPerformanceProfile, } from "@smileid/usesmileid_bridge";
+import { CaptureType, } from "../../../../core/models/ml_config";
+/**
+ * `b.ml((m) => { m.analyzers((a) => { a.forCaptureType(CaptureType.selfie, (face) => face.add(useSmileIDVisionFace)); }); })`
+ *
+ * Shape: `ml → analyzers → forCaptureType(type, callback) → add(analyzer)`
+ *
+ * Each provider package (`usesmileid_vision_face`,
+ * `usesmileid_mlkit_face`, …) exports a ready-to-use `FaceAnalyzer`
+ * / `DocumentAnalyzer` value. Partners register them per capture
+ * type via `forCaptureType`.
+ *
+ * Type-safety note: distinct `Face*` and `Document*` scope classes
+ * prevent the partner from setting the wrong slot inside a
+ * `forCaptureType` closure. Without this, a typo like
+ * `forCaptureType(CaptureType.selfie, (a) => a.documentAnalyzer = ...)` would
+ * silently drop the document analyzer and leave the face slot empty —
+ * the orchestrator would then refuse to run face capture with no
+ * clear cause. Distinct scopes block that at compile time.
+ */
+export class FaceAnalyzerScope {
+    /** Register the face analyzer for this scope. */
+    add(analyzer) {
+        this._analyzer = analyzer;
+    }
+    /** @internal */
+    _analyzer;
+    /**
+     * Scan-loop tuning preset (Fast / Balanced / HighQuality). Default is
+     * `Balanced`; the orchestrator lifts the field into `FaceConfig` at
+     * configure time.
+     */
+    scanPerformanceProfile = ScanPerformanceProfile.Balanced;
+    /**
+     * Face-detection preset. A token (`"performance"` / `"default"` / `"low"`)
+     * the native backend resolves to its own engine-calibrated thresholds;
+     * defaults to `"default"`. Set individual {@link faceDetectorConfig} fields
+     * to override specific thresholds on top of the resolved preset.
+     */
+    detectorMode = "default";
+    /**
+     * Fine-grained face-detector thresholds. Omit to use the native
+     * session's platform-tuned defaults — partners typically leave this
+     * `undefined` and only set it for specific device/lighting
+     * constraints.
+     */
+    faceDetectorConfig;
+    /**
+     * Lift the DSL state into the wire-shape `FaceConfig` that
+     * `FaceAnalyzer.configure()` consumes.
+     *
+     * Returns `undefined` when no analyzer has been registered — callers
+     * skip the `configure()` call in that case rather than pushing a partial
+     * config at the native side.
+     *
+     * @internal
+     */
+    toFaceConfig() {
+        const analyzer = this._analyzer;
+        if (!analyzer)
+            return undefined;
+        const profile = this.scanPerformanceProfile;
+        const detector = this.faceDetectorConfig;
+        return {
+            selfieCaptureTimeout: profile.timeoutMs,
+            numSamples: profile.numSamples,
+            sampleInterval: profile.sampleIntervalMs,
+            stayInFoundDuration: profile.stayInFoundMs,
+            // Detection preset token. The native backend resolves this to its own
+            // engine-calibrated thresholds; the explicit fields below (when set)
+            // are overlaid on top of that resolved preset.
+            faceDetectorMode: this.detectorMode,
+            // Detector thresholds — spread only when the partner set them; the
+            // wire schema treats `undefined` as "use the native default".
+            ...(detector?.minFillThreshold !== undefined
+                ? { minFillThreshold: detector.minFillThreshold }
+                : {}),
+            ...(detector?.maxFillThreshold !== undefined
+                ? { maxFillThreshold: detector.maxFillThreshold }
+                : {}),
+            ...(detector?.faceDetectorMinScore !== undefined
+                ? { faceDetectorMinScore: detector.faceDetectorMinScore }
+                : {}),
+            ...(detector?.centerToleranceX !== undefined
+                ? { centerToleranceX: detector.centerToleranceX }
+                : {}),
+            ...(detector?.centerToleranceY !== undefined
+                ? { centerToleranceY: detector.centerToleranceY }
+                : {}),
+            ...(detector?.motionBlurMinIou !== undefined
+                ? { motionBlurMinIou: detector.motionBlurMinIou }
+                : {}),
+            ...(detector?.motionBlurMinDuration !== undefined
+                ? { motionBlurMinDuration: detector.motionBlurMinDuration }
+                : {}),
+            ...(detector?.minTopPadding !== undefined
+                ? { minTopPadding: detector.minTopPadding }
+                : {}),
+            ...(detector?.minFaceBoundsThreshold !== undefined
+                ? { minFaceBoundsThreshold: detector.minFaceBoundsThreshold }
+                : {}),
+            ...(detector?.maxFaceBoundsThreshold !== undefined
+                ? { maxFaceBoundsThreshold: detector.maxFaceBoundsThreshold }
+                : {}),
+            ...(detector?.minSmileProbability !== undefined
+                ? { minSmileProbability: detector.minSmileProbability }
+                : {}),
+            analyzerFactoryKey: analyzer.key,
+        };
+    }
+}
+export class DocumentAnalyzerScope {
+    /** Register the document analyzer for this scope. */
+    add(analyzer) {
+        this._analyzer = analyzer;
+    }
+    /** @internal */
+    _analyzer;
+}
+export class AnalyzerRegistryBuilder {
+    _selfie;
+    _selfieConfig;
+    _document;
+    forCaptureType(captureType, block) {
+        if (captureType === CaptureType.selfie) {
+            const scope = new FaceAnalyzerScope();
+            block(scope);
+            if (scope._analyzer) {
+                this._selfie = scope._analyzer;
+                // Snapshot the scope's DSL state into a wire `FaceConfig` now —
+                // build() time — so the orchestrator never has to reach into the
+                // builder.
+                this._selfieConfig = scope.toFaceConfig();
+            }
+            return;
+        }
+        const scope = new DocumentAnalyzerScope();
+        block(scope);
+        if (scope._analyzer)
+            this._document = scope._analyzer;
+    }
+    build() {
+        return Object.freeze({
+            ...(this._selfie ? { selfie: this._selfie } : {}),
+            ...(this._selfieConfig ? { selfieConfig: this._selfieConfig } : {}),
+            ...(this._document ? { document: this._document } : {}),
+        });
+    }
+}
+export class UseSmileIDMLBuilder {
+    _analyzers;
+    analyzers(block) {
+        if (!this._analyzers)
+            this._analyzers = new AnalyzerRegistryBuilder();
+        block(this._analyzers);
+    }
+    build() {
+        return Object.freeze({
+            analyzers: this._analyzers ? this._analyzers.build() : Object.freeze({}),
+        });
+    }
+}
+//# sourceMappingURL=ml_builder.js.map

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

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

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

@@ -0,0 +1,122 @@
+import type { ReactNode } from "react";
+import { CaptureType } from "../../../../core/models/ml_config";
+import type { DocumentType } from "../../../../core/models/document_type";
+import { DocumentCaptureMode } from "../../../../core/models/document_capture_mode";
+import type { ConsentInformation } from "../../../../core/models/params";
+import type { InstructionGuideline } from "../../model/instruction_guideline";
+import type { HeroAnimationSource } from "../../model/instructions_defaults";
+export { CaptureType };
+/**
+ * Screens DSL:
+ *
+ *   screens → consent((c) => …)
+ *           → instructions((i) => …)
+ *           → capture({ captureType }, (cap) => cap.selfie(…) | cap.document(…))
+ *           → preview((p) => …)
+ *           → processing((p) => …)
+ *
+ * Each screen-builder call appends a step to the orchestrator's
+ * `flowSteps` list in the order declared. The partner can omit
+ * screens entirely (no `screens.consent(…)` call → no consent screen).
+ */
+export type ButtonSlot = (props: {
+    onClick: () => void;
+    enabled: boolean;
+}) => ReactNode;
+export declare class ConsentConfigBuilder {
+    partnerName: string;
+    /** Partner brand mark rendered next to the Smile ID icon at the top of the consent screen. */
+    partnerIcon?: ReactNode;
+    partnerPrivacyPolicyUrl?: string;
+    showAttribution: boolean;
+    onConsentGranted?: (info: ConsentInformation) => void;
+    allowButton?: ButtonSlot;
+    denyButton?: ButtonSlot;
+}
+export declare class InstructionsConfigBuilder {
+    /** Leading title text (title-text colour). Defaults to the localized prefix. */
+    titlePrefix?: string;
+    /** Emphasized word (primary colour, own line). Defaults to the localized "selfie". */
+    titleEmphasis?: string;
+    /** Lottie hero. Unset uses the selfie hero (or the ESS hero when enhanced liveness is on). */
+    heroAnimation?: HeroAnimationSource;
+    /** Capture-guidelines section title (rendered uppercase). */
+    guidelinesSectionTitle?: string;
+    /** Capture-guideline tiles; push to customize. Empty uses the defaults. */
+    guidelines: InstructionGuideline[];
+    showAttribution: boolean;
+    /** Draw the face-oval ring around the hero animation. */
+    showHeroOval: boolean;
+    continueButton?: ButtonSlot;
+}
+export declare class SelfieCaptureConfigBuilder {
+    allowAgentMode: boolean;
+    enableEnhancedLiveness: boolean;
+}
+export declare class DocumentCaptureConfigBuilder {
+    /** The document being captured. **Required** — missing it fails validation. */
+    documentType?: DocumentType;
+    /** When the photo is taken. Defaults to auto-capture with a 10s manual fallback. */
+    captureMode: DocumentCaptureMode;
+    allowGalleryUpload: boolean;
+    captureBothSides: boolean;
+    allowSkipBack: boolean;
+    /** Optional aspect ratio hint — e.g. CR-80 ID card = 1.586. */
+    knownIdAspectRatio?: number;
+    /** The `documentType`'s aspect ratio when present, otherwise `knownIdAspectRatio`. */
+    get resolvedAspectRatio(): number | undefined;
+}
+export declare class CaptureConfigBuilder {
+    captureType?: CaptureType;
+    startButton?: ButtonSlot;
+    private _selfie?;
+    private _document?;
+    selfie(block: (s: SelfieCaptureConfigBuilder) => void): void;
+    document(block: (d: DocumentCaptureConfigBuilder) => void): void;
+    /** @internal Snapshot used by the orchestrator. */
+    get selfieConfig(): SelfieCaptureConfigBuilder | undefined;
+    /** @internal Snapshot used by the orchestrator. */
+    get documentConfig(): DocumentCaptureConfigBuilder | undefined;
+}
+export declare class PreviewConfigBuilder {
+    allowRetake: boolean;
+    showAttribution: boolean;
+    continueButton?: ButtonSlot;
+    cancelButton?: ButtonSlot;
+}
+export declare class ProcessingConfigBuilder {
+    showProgressPercentage: boolean;
+    showAttribution: boolean;
+    continueButton?: ButtonSlot;
+    retryButton?: ButtonSlot;
+    exitButton?: ButtonSlot;
+}
+export type ScreenSpec = {
+    readonly kind: "consent";
+    readonly config: ConsentConfigBuilder;
+} | {
+    readonly kind: "instructions";
+    readonly config: InstructionsConfigBuilder;
+} | {
+    readonly kind: "capture";
+    readonly config: CaptureConfigBuilder;
+} | {
+    readonly kind: "preview";
+    readonly config: PreviewConfigBuilder;
+} | {
+    readonly kind: "processing";
+    readonly config: ProcessingConfigBuilder;
+};
+export type ScreensConfig = {
+    readonly steps: readonly ScreenSpec[];
+};
+export declare class ScreensBuilder {
+    private _steps;
+    consent(block?: (c: ConsentConfigBuilder) => void): void;
+    instructions(block?: (i: InstructionsConfigBuilder) => void): void;
+    capture(block: (c: CaptureConfigBuilder) => void): void;
+    preview(block?: (p: PreviewConfigBuilder) => void): void;
+    processing(block?: (p: ProcessingConfigBuilder) => void): void;
+    build(): ScreensConfig;
+}
+//# sourceMappingURL=screens_builder.d.ts.map

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

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

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

@@ -0,0 +1,119 @@
+import { CaptureType } from "../../../../core/models/ml_config";
+import { DocumentCaptureMode } from "../../../../core/models/document_capture_mode";
+export { CaptureType };
+// --- Per-screen builders ---------------------------------------------------
+export class ConsentConfigBuilder {
+    partnerName = "";
+    /** Partner brand mark rendered next to the Smile ID icon at the top of the consent screen. */
+    partnerIcon;
+    partnerPrivacyPolicyUrl;
+    showAttribution = true;
+    onConsentGranted;
+    allowButton;
+    denyButton;
+}
+export class InstructionsConfigBuilder {
+    /** Leading title text (title-text colour). Defaults to the localized prefix. */
+    titlePrefix;
+    /** Emphasized word (primary colour, own line). Defaults to the localized "selfie". */
+    titleEmphasis;
+    /** Lottie hero. Unset uses the selfie hero (or the ESS hero when enhanced liveness is on). */
+    heroAnimation;
+    /** Capture-guidelines section title (rendered uppercase). */
+    guidelinesSectionTitle;
+    /** Capture-guideline tiles; push to customize. Empty uses the defaults. */
+    guidelines = [];
+    showAttribution = true;
+    /** Draw the face-oval ring around the hero animation. */
+    showHeroOval = true;
+    continueButton;
+}
+export class SelfieCaptureConfigBuilder {
+    allowAgentMode = false;
+    enableEnhancedLiveness = false;
+}
+export class DocumentCaptureConfigBuilder {
+    /** The document being captured. **Required** — missing it fails validation. */
+    documentType;
+    /** When the photo is taken. Defaults to auto-capture with a 10s manual fallback. */
+    captureMode = DocumentCaptureMode.AutoCaptureWithManualFallback();
+    allowGalleryUpload = false;
+    captureBothSides = true;
+    allowSkipBack = false;
+    /** Optional aspect ratio hint — e.g. CR-80 ID card = 1.586. */
+    knownIdAspectRatio;
+    /** The `documentType`'s aspect ratio when present, otherwise `knownIdAspectRatio`. */
+    get resolvedAspectRatio() {
+        return this.documentType?.knownAspectRatio ?? this.knownIdAspectRatio;
+    }
+}
+export class CaptureConfigBuilder {
+    captureType;
+    startButton;
+    _selfie;
+    _document;
+    selfie(block) {
+        if (!this._selfie)
+            this._selfie = new SelfieCaptureConfigBuilder();
+        block(this._selfie);
+    }
+    document(block) {
+        if (!this._document)
+            this._document = new DocumentCaptureConfigBuilder();
+        block(this._document);
+    }
+    /** @internal Snapshot used by the orchestrator. */
+    get selfieConfig() {
+        return this._selfie;
+    }
+    /** @internal Snapshot used by the orchestrator. */
+    get documentConfig() {
+        return this._document;
+    }
+}
+export class PreviewConfigBuilder {
+    allowRetake = true;
+    showAttribution = true;
+    continueButton;
+    cancelButton;
+}
+export class ProcessingConfigBuilder {
+    showProgressPercentage = true;
+    showAttribution = true;
+    continueButton;
+    retryButton;
+    exitButton;
+}
+// --- Top-level screens builder ---------------------------------------------
+export class ScreensBuilder {
+    _steps = [];
+    consent(block) {
+        const config = new ConsentConfigBuilder();
+        block?.(config);
+        this._steps.push({ kind: "consent", config });
+    }
+    instructions(block) {
+        const config = new InstructionsConfigBuilder();
+        block?.(config);
+        this._steps.push({ kind: "instructions", config });
+    }
+    capture(block) {
+        const config = new CaptureConfigBuilder();
+        block(config);
+        this._steps.push({ kind: "capture", config });
+    }
+    preview(block) {
+        const config = new PreviewConfigBuilder();
+        block?.(config);
+        this._steps.push({ kind: "preview", config });
+    }
+    processing(block) {
+        const config = new ProcessingConfigBuilder();
+        block?.(config);
+        this._steps.push({ kind: "processing", config });
+    }
+    build() {
+        return Object.freeze({ steps: Object.freeze([...this._steps]) });
+    }
+}
+//# sourceMappingURL=screens_builder.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { type UseSmileIDTheme } from "../../../theme/theme";
+/** A color that adapts to the active light/dark color scheme. */
+export type AdaptiveColor = {
+    readonly light: string;
+    readonly dark: string;
+};
+/** Pair of resolved themes — renderer picks one based on system scheme. */
+export type ThemeConfiguration = {
+    readonly light: UseSmileIDTheme;
+    readonly dark: UseSmileIDTheme;
+};
+/**
+ * `b.theme((t) => { t.primaryColor = color('#1A73E8', '#4DA3FF'); })`
+ *
+ * Each color slot accepts an [AdaptiveColor] pair. Build produces a
+ * [ThemeConfiguration] carrying both resolved themes; the renderer
+ * picks light or dark at mount time based on the active color scheme.
+ */
+export declare class ThemeConfigBuilder {
+    primaryColor?: AdaptiveColor;
+    primaryForeground?: AdaptiveColor;
+    secondaryColor?: AdaptiveColor;
+    accentColor?: AdaptiveColor;
+    fontFamily?: string;
+    buttonShape?: number;
+    cardShape?: number;
+    /** Helper to create an `AdaptiveColor` with explicit light/dark values. */
+    color(light: string, dark: string): AdaptiveColor;
+    /**
+     * Helper to create a button/card shape value. Returns the input
+     * radius unchanged — React Native resolves shape at render time via
+     * `borderRadius`, so the `buttonShape` / `cardShape` properties are
+     * plain numbers.
+     */
+    shape(radius: number): number;
+    /**
+     * Build a [ThemeConfiguration] that pairs a fully-resolved light
+     * theme with its dark counterpart. Each `AdaptiveColor` override maps
+     * to its canonical key on the matching variant.
+     */
+    build(): ThemeConfiguration;
+    private _resolve;
+}
+//# sourceMappingURL=theme_builder.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,70 @@
+import { DEFAULT_FONT_FAMILY, defaultDarkTheme, defaultLightTheme, typographyWithFontFamily, } from "../../../theme/theme";
+/**
+ * `b.theme((t) => { t.primaryColor = color('#1A73E8', '#4DA3FF'); })`
+ *
+ * Each color slot accepts an [AdaptiveColor] pair. Build produces a
+ * [ThemeConfiguration] carrying both resolved themes; the renderer
+ * picks light or dark at mount time based on the active color scheme.
+ */
+export class ThemeConfigBuilder {
+    primaryColor;
+    primaryForeground;
+    secondaryColor;
+    accentColor;
+    fontFamily;
+    buttonShape;
+    cardShape;
+    /** Helper to create an `AdaptiveColor` with explicit light/dark values. */
+    color(light, dark) {
+        return Object.freeze({ light, dark });
+    }
+    /**
+     * Helper to create a button/card shape value. Returns the input
+     * radius unchanged — React Native resolves shape at render time via
+     * `borderRadius`, so the `buttonShape` / `cardShape` properties are
+     * plain numbers.
+     */
+    shape(radius) {
+        return radius;
+    }
+    /**
+     * Build a [ThemeConfiguration] that pairs a fully-resolved light
+     * theme with its dark counterpart. Each `AdaptiveColor` override maps
+     * to its canonical key on the matching variant.
+     */
+    build() {
+        return Object.freeze({
+            light: this._resolve("light", defaultLightTheme),
+            dark: this._resolve("dark", defaultDarkTheme),
+        });
+    }
+    _resolve(variant, base) {
+        const pick = (c) => c === undefined ? undefined : c[variant];
+        // Capture each picked colour once so the `!== undefined` guard narrows
+        // it to `string` — re-invoking `pick` inside the spread value would
+        // leave it `string | undefined` and trip `exactOptionalPropertyTypes`.
+        const primary = pick(this.primaryColor);
+        const primaryForeground = pick(this.primaryForeground);
+        const secondary = pick(this.secondaryColor);
+        const accent = pick(this.accentColor);
+        const colorOverrides = {
+            ...(primary !== undefined ? { primary } : {}),
+            ...(primaryForeground !== undefined ? { primaryForeground } : {}),
+            ...(secondary !== undefined ? { secondary } : {}),
+            ...(accent !== undefined ? { accent } : {}),
+        };
+        return Object.freeze({
+            ...base,
+            colors: { ...base.colors, ...colorOverrides },
+            typography: typographyWithFontFamily(base.typography, this.fontFamily ?? DEFAULT_FONT_FAMILY),
+            shapes: {
+                ...base.shapes,
+                ...(this.buttonShape !== undefined
+                    ? { buttonRadius: this.buttonShape }
+                    : {}),
+                ...(this.cardShape !== undefined ? { cardRadius: this.cardShape } : {}),
+            },
+        });
+    }
+}
+//# sourceMappingURL=theme_builder.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,35 @@
+import type { ValidationStateInvalid } from "../validation/validation_state";
+import type { FlowConfigurationSnapshot } from "./use_smile_id_flow_builder";
+/**
+ * Result of `useSmileIDBuilder(configure)` and the internal
+ * `UseSmileIDFlowBuilder.build()`.
+ *
+ * Discriminated on `kind`. This type is `@internal` — partners interact
+ * with `<UseSmileIDBuilder>` exclusively, which calls `build()` and
+ * dispatches on the result. The `kind: 'invalid'` case is delivered
+ * to partners as a typed `BuilderValidationException` through
+ * `onResult.failure`.
+ */
+export type FlowBuildResult = FlowBuildResultSuccess | FlowBuildResultInvalid;
+/**
+ * Builder produced a configuration that passed every validation rule.
+ * `<UseSmileIDBuilder>` renders this case end-to-end.
+ */
+export type FlowBuildResultSuccess = {
+    readonly kind: "success";
+    readonly configuration: FlowConfigurationSnapshot;
+};
+/**
+ * Builder produced at least one `error`-severity validation issue.
+ * `validation` carries the invalid branch of [ValidationState] — its
+ * `issues` array is non-empty by construction.
+ *
+ * The wrapper component that renders the failure sources `onResult` /
+ * `enableDebugMode` from the builder reference it already holds rather
+ * than from this result.
+ */
+export type FlowBuildResultInvalid = {
+    readonly kind: "invalid";
+    readonly validation: ValidationStateInvalid;
+};
+//# sourceMappingURL=flow_build_result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow_build_result.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/flow_build_result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;CACnD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;CAC7C,CAAC"}

package/dist/presentation/flow/dsl/flow_build_result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flow_build_result.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow_build_result.js","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/flow_build_result.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,59 @@
+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].
+ *
+ *     export function VerifyScreen({ onComplete }) {
+ *       return (
+ *         <UseSmileIDBuilder
+ *           builder={(b) => {
+ *             b.network((n) => n.config((c) => {
+ *               c.jobType = JobType.smartSelfieEnrollment;
+ *               c.token = '...';
+ *               c.partnerConfig((p) => { p.partnerId = '...'; });
+ *             }));
+ *             b.ml((m) => m.analyzers((a) => {
+ *               a.forCaptureType(CaptureType.selfie, (face) => face.add(useSmileIDVisionFace));
+ *             }));
+ *             b.screens((screens) => {
+ *               screens.instructions();
+ *               screens.capture((c) => { c.captureType = CaptureType.selfie; });
+ *               screens.preview();
+ *             });
+ *             b.onResult = (result) => { ... onComplete(); };
+ *           }}
+ *         />
+ *       );
+ *     }
+ *
+ * Validation outcomes:
+ *   - Success → renders the configured screen flow.
+ *   - Invalid → fires `b.onResult.failure` with a typed
+ *     `BuilderValidationException`. Additionally renders a
+ *     debug-only `ValidationErrorScreen` when
+ *     `b.config((c) => c.enableDebugMode = true)` is set.
+ *
+ * The `builder` closure runs once when the component mounts. Partners
+ * that need to recompute the flow on prop changes should remount via
+ * a `key` prop on `<UseSmileIDBuilder>` rather than mutate the
+ * closure's captures in place.
+ */
+export type UseSmileIDBuilderProps = {
+    readonly builder: (b: UseSmileIDFlowBuilder) => void;
+};
+export declare function UseSmileIDBuilder({ builder }: UseSmileIDBuilderProps): import("react").JSX.Element;
+/**
+ * Function form of the builder, retained for tests and any partner
+ * code that wants to inspect the [FlowBuildResult] before rendering
+ * (for example, a custom failure UI). Most partners should use the
+ * `<UseSmileIDBuilder>` component instead.
+ *
+ * @internal
+ */
+export declare function useSmileIDBuilder(configure: (builder: UseSmileIDFlowBuilder) => void): FlowBuildResult;
+export { UseSmileIDFlowBuilder, type FlowConfigurationSnapshot, } from "./use_smile_id_flow_builder";
+export type { FlowBuildResult, FlowBuildResultSuccess, FlowBuildResultInvalid, } from "./flow_build_result";
+//# sourceMappingURL=use_smile_id_builder.d.ts.map