@incodetech/web 2.1.1 → 2.2.0-rc.1

package/dist/types/id-selfie-flow.d.ts

@@ -0,0 +1,161 @@
+import { FC } from 'preact/compat';
+import { FinishStatus } from '@incodetech/core/flow';
+import { FunctionComponent } from 'preact';
+import { IdSelfieFlowConfig } from '@incodetech/core/id-selfie-flow';
+import { SVGProps } from 'preact/compat';
+
+/**
+ * Allowlisted keys for overridable Lottie animations
+ */
+declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in Lottie animation.
+ *
+ * - `LottieAnimationData` — a parsed Lottie JSON object.
+ * - `{ url }` — fetched and cached at runtime.
+ * - `{ animationData }` — explicit object form.
+ */
+declare type AnimationOverride = LottieAnimationData | {
+    url: string;
+} | {
+    animationData: LottieAnimationData;
+};
+
+declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
+
+/**
+ * Allowlisted keys for overridable branded SVG illustrations
+ */
+declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in SVG illustration.
+ *
+ * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
+ * - `{ url }` — fetched and rendered via `<img>`; no script execution.
+ * - `{ raw }` — inline markup; sanitized before injection.
+ * - `{ svg }` — a precompiled component, for build-time integrations.
+ */
+declare type AssetOverride = string | {
+    url: string;
+} | {
+    raw: string;
+} | {
+    svg: SvgComponent;
+};
+
+declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
+
+/**
+ * A module `config` intersected with the per-instance override maps. Typed at
+ * the UI boundary so core config types (e.g. `IdCaptureConfig`) stay untouched;
+ * `FlowConfig` also declares the maps directly.
+ */
+declare type ConfigWithOverrides<TConfig> = TConfig & InstanceOverrides;
+
+/**
+ * ID + Selfie flow UI component (PoC). Runs the regular ID + selfie capture
+ * pipeline behind the Video Selfie continuous-camera UX.
+ *
+ * Config is resolved from the active session's FLOW configuration (the same
+ * dashboard config the regular ID and SELFIE modules read — steps, attempts,
+ * tutorial, selfie validations); any `config` prop values win over the
+ * flow-derived ones.
+ *
+ * @see {@link createIdSelfieFlowManager} for headless usage.
+ */
+export declare const IdSelfieFlow: FC<IdSelfieFlowProps>;
+
+/** Props for the {@link IdSelfieFlow} component. */
+declare type IdSelfieFlowProps = Omit<IncodeModuleProps<IdSelfieFlowConfig>, 'onFinish'> & {
+    /** Fired on completion with the session's finish status. */
+    onFinish?: (finishStatus?: FinishStatus) => void;
+};
+
+/**
+ * Extra context passed to `onFinish` alongside the result. Lets a host decide
+ * how to react to the terminal state without inspecting the DOM. Only the
+ * workflow module sets these fields today.
+ */
+declare type IncodeFinishMeta = {
+    /**
+     * True when the SDK owns the terminal screen — it has already rendered its
+     * own finish UI (today, the workflow's `showFinishScreenBySessionStatus`
+     * screen), so the host should not render its own completion screen on top.
+     * `onFinish` still fires so the host can run side effects (e.g. notify an
+     * OAuth parent).
+     *
+     * Advisory only: the SDK cannot stop a host from rendering. This works solely
+     * because the host reads this flag — a host that ignores it will still
+     * replace the SDK screen. Not a guarantee.
+     */
+    sdkOwnsTerminalScreen?: boolean;
+};
+
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TConfigInput = ConfigWithOverrides<TConfig>> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     *
+     * Also carries optional per-instance `assets`/`animations` override maps;
+     * they override the global `setup({ uiConfig })` values for this
+     * element only and are ignored by the core manager.
+     */
+    config?: TConfigInput;
+    /**
+     * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
+     */
+    manager?: TManager;
+    /**
+     * Callback invoked when the module completes successfully.
+     * @param result - Optional result data from the module completion
+     * @param meta - Optional context about how the module resolved (e.g. whether
+     *   the SDK rendered its own terminal finish screen). See {@link IncodeFinishMeta}.
+     */
+    onFinish?: (result?: TResult, meta?: IncodeFinishMeta) => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     *
+     * @param error - Human-readable error message.
+     * @param errorCode - Optional numeric code (e.g. HTTP status). Populated by
+     *   the workflow and flow modules on QR validation failures —
+     *   `4026` (`expiredUUID`), `4081` (`invalidQRuuid`) or `4083` (`onboardingUrlAlreadyUsed`).
+     * @param moduleErrorCode - Optional machine-readable error code (e.g. a
+     *   `FaceErrorCode` such as `NONEXISTENT_CUSTOMER`). Lets an orchestrator
+     *   branch on the specific terminal error without parsing the message string.
+     */
+    onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
+};
+
+/**
+ * Per-instance asset/animation overrides for a single mounted SDK module.
+ *
+ * These ride on the module's `config` prop and are published once at the
+ * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
+ * reads them via {@link useInstanceOverrides} without any prop drilling.
+ */
+declare type InstanceOverrides = {
+    assets?: AssetOverrides;
+    animations?: AnimationOverrides;
+};
+
+declare type LottieAnimationData = {
+    fr: number;
+    v: string;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+};
+
+/** An SVG imported as a Preact component (the `?react` import shape). */
+declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
+
+export { }
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'incode-id-selfie-flow': HTMLElement & IncodeModuleProps<IdSelfieFlowConfig>;
+    }
+}

package/dist/types/id-verification.d.ts

@@ -1,9 +1,62 @@
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
 import { IdVerificationConfig } from '@incodetech/core/id-verification';
+import { IdVerificationManager } from '@incodetech/core/id-verification';
+import { SVGProps } from 'preact/compat';
+
+/**
+ * Allowlisted keys for overridable Lottie animations
+ */
+declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in Lottie animation.
+ *
+ * - `LottieAnimationData` — a parsed Lottie JSON object.
+ * - `{ url }` — fetched and cached at runtime.
+ * - `{ animationData }` — explicit object form.
+ */
+declare type AnimationOverride = LottieAnimationData | {
+    url: string;
+} | {
+    animationData: LottieAnimationData;
+};
+
+declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
+
+/**
+ * Allowlisted keys for overridable branded SVG illustrations
+ */
+declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in SVG illustration.
+ *
+ * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
+ * - `{ url }` — fetched and rendered via `<img>`; no script execution.
+ * - `{ raw }` — inline markup; sanitized before injection.
+ * - `{ svg }` — a precompiled component, for build-time integrations.
+ */
+declare type AssetOverride = string | {
+    url: string;
+} | {
+    raw: string;
+} | {
+    svg: SvgComponent;
+};
+
+declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
+
+/**
+ * A module `config` intersected with the per-instance override maps. Typed at
+ * the UI boundary so core config types (e.g. `IdCaptureConfig`) stay untouched;
+ * `FlowConfig` also declares the maps directly.
+ */
+declare type ConfigWithOverrides<TConfig> = TConfig & InstanceOverrides;
 
 export declare const IdVerification: FC<IdVerificationProps>;
 
-declare type IdVerificationProps = IncodeModuleProps<IdVerificationConfig>;
+declare type IdVerificationProps = IncodeModuleProps<IdVerificationConfig, void, IdVerificationManager>;
 
 /**
  * Extra context passed to `onFinish` alongside the result. Lets a host decide
@@ -25,12 +78,16 @@ declare type IncodeFinishMeta = {
     sdkOwnsTerminalScreen?: boolean;
 };
 
-declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TConfigInput = ConfigWithOverrides<TConfig>> = {
     /**
      * Module configuration required to render the flow.
      * For Web Components, this is typically assigned via `element.config = ...`.
+     *
+     * Also carries optional per-instance `assets`/`animations` override maps;
+     * they override the global `setup({ uiConfig })` values for this
+     * element only and are ignored by the core manager.
      */
-    config?: TConfig;
+    config?: TConfigInput;
     /**
      * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
      */
@@ -56,10 +113,36 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
+/**
+ * Per-instance asset/animation overrides for a single mounted SDK module.
+ *
+ * These ride on the module's `config` prop and are published once at the
+ * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
+ * reads them via {@link useInstanceOverrides} without any prop drilling.
+ */
+declare type InstanceOverrides = {
+    assets?: AssetOverrides;
+    animations?: AnimationOverrides;
+};
+
+declare type LottieAnimationData = {
+    fr: number;
+    v: string;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+};
+
+/** An SVG imported as a Preact component (the `?react` import shape). */
+declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
+
 export { }
 
 declare global {
     interface HTMLElementTagNameMap {
-        'incode-id-verification': HTMLElement & IncodeModuleProps<IdVerificationConfig>;
+        'incode-id-verification': HTMLElement & IncodeModuleProps<IdVerificationConfig,
+  void,
+  IdVerificationManager>;
     }
 }

package/dist/types/id.d.ts

@@ -1,10 +1,65 @@
+import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
 import { IdCaptureConfig } from '@incodetech/core/id';
 import { IdCaptureManager } from '@incodetech/core/id';
+import { SVGProps } from 'preact/compat';
 
-export declare const Id: FC<IdProps>;
+/**
+ * Allowlisted keys for overridable Lottie animations
+ */
+declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in Lottie animation.
+ *
+ * - `LottieAnimationData` — a parsed Lottie JSON object.
+ * - `{ url }` — fetched and cached at runtime.
+ * - `{ animationData }` — explicit object form.
+ */
+declare type AnimationOverride = LottieAnimationData | {
+    url: string;
+} | {
+    animationData: LottieAnimationData;
+};
+
+declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
+
+/**
+ * Allowlisted keys for overridable branded SVG illustrations
+ */
+declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in SVG illustration.
+ *
+ * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
+ * - `{ url }` — fetched and rendered via `<img>`; no script execution.
+ * - `{ raw }` — inline markup; sanitized before injection.
+ * - `{ svg }` — a precompiled component, for build-time integrations.
+ */
+declare type AssetOverride = string | {
+    url: string;
+} | {
+    raw: string;
+} | {
+    svg: SvgComponent;
+};
 
-declare type IdProps = IncodeModuleProps<IdCaptureConfig, void, IdCaptureManager>;
+declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
+
+/**
+ * A module `config` intersected with the per-instance override maps. Typed at
+ * the UI boundary so core config types (e.g. `IdCaptureConfig`) stay untouched;
+ * `FlowConfig` also declares the maps directly.
+ */
+declare type ConfigWithOverrides<TConfig> = TConfig & InstanceOverrides;
+
+export declare const Id: FC<Omit<IdProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
+
+declare type IdProps = IncodeModuleProps<IdCaptureConfig, unknown, IdCaptureManager>;
 
 /**
  * Extra context passed to `onFinish` alongside the result. Lets a host decide
@@ -26,12 +81,16 @@ declare type IncodeFinishMeta = {
     sdkOwnsTerminalScreen?: boolean;
 };
 
-declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TConfigInput = ConfigWithOverrides<TConfig>> = {
     /**
      * Module configuration required to render the flow.
      * For Web Components, this is typically assigned via `element.config = ...`.
+     *
+     * Also carries optional per-instance `assets`/`animations` override maps;
+     * they override the global `setup({ uiConfig })` values for this
+     * element only and are ignored by the core manager.
      */
-    config?: TConfig;
+    config?: TConfigInput;
     /**
      * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
      */
@@ -57,10 +116,34 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
+/**
+ * Per-instance asset/animation overrides for a single mounted SDK module.
+ *
+ * These ride on the module's `config` prop and are published once at the
+ * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
+ * reads them via {@link useInstanceOverrides} without any prop drilling.
+ */
+declare type InstanceOverrides = {
+    assets?: AssetOverrides;
+    animations?: AnimationOverrides;
+};
+
+declare type LottieAnimationData = {
+    fr: number;
+    v: string;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+};
+
+/** An SVG imported as a Preact component (the `?react` import shape). */
+declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
+
 export { }
 
 declare global {
     interface HTMLElementTagNameMap {
-        'incode-id': HTMLElement & IncodeModuleProps<IdCaptureConfig, void, IdCaptureManager>;
+        'incode-id': HTMLElement & IncodeModuleProps<IdCaptureConfig, unknown, IdCaptureManager>;
     }
 }

package/dist/types/identity-reuse.d.ts

@@ -1,6 +1,58 @@
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
 import { IdentityReuseConfig } from '@incodetech/core/identity-reuse';
 import { IdentityReuseManager } from '@incodetech/core/identity-reuse';
+import { SVGProps } from 'preact/compat';
+
+/**
+ * Allowlisted keys for overridable Lottie animations
+ */
+declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in Lottie animation.
+ *
+ * - `LottieAnimationData` — a parsed Lottie JSON object.
+ * - `{ url }` — fetched and cached at runtime.
+ * - `{ animationData }` — explicit object form.
+ */
+declare type AnimationOverride = LottieAnimationData | {
+    url: string;
+} | {
+    animationData: LottieAnimationData;
+};
+
+declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
+
+/**
+ * Allowlisted keys for overridable branded SVG illustrations
+ */
+declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in SVG illustration.
+ *
+ * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
+ * - `{ url }` — fetched and rendered via `<img>`; no script execution.
+ * - `{ raw }` — inline markup; sanitized before injection.
+ * - `{ svg }` — a precompiled component, for build-time integrations.
+ */
+declare type AssetOverride = string | {
+    url: string;
+} | {
+    raw: string;
+} | {
+    svg: SvgComponent;
+};
+
+declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
+
+/**
+ * A module `config` intersected with the per-instance override maps. Typed at
+ * the UI boundary so core config types (e.g. `IdCaptureConfig`) stay untouched;
+ * `FlowConfig` also declares the maps directly.
+ */
+declare type ConfigWithOverrides<TConfig> = TConfig & InstanceOverrides;
 
 export declare const IdentityReuse: FC<IdentityReuseProps>;
 
@@ -26,12 +78,16 @@ declare type IncodeFinishMeta = {
     sdkOwnsTerminalScreen?: boolean;
 };
 
-declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
+declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown, TConfigInput = ConfigWithOverrides<TConfig>> = {
     /**
      * Module configuration required to render the flow.
      * For Web Components, this is typically assigned via `element.config = ...`.
+     *
+     * Also carries optional per-instance `assets`/`animations` override maps;
+     * they override the global `setup({ uiConfig })` values for this
+     * element only and are ignored by the core manager.
      */
-    config?: TConfig;
+    config?: TConfigInput;
     /**
      * Optional pre-built manager. When provided, the module does not create or manage the manager lifecycle.
      */
@@ -57,6 +113,30 @@ declare type IncodeModuleProps<TConfig, TResult = void, TManager = unknown> = {
     onError?: (error: string | undefined, errorCode?: number, moduleErrorCode?: string) => void;
 };
 
+/**
+ * Per-instance asset/animation overrides for a single mounted SDK module.
+ *
+ * These ride on the module's `config` prop and are published once at the
+ * module root by `registerIncodeModuleElement`, so a deep `<Asset>`/`<AnimatedAsset>`
+ * reads them via {@link useInstanceOverrides} without any prop drilling.
+ */
+declare type InstanceOverrides = {
+    assets?: AssetOverrides;
+    animations?: AnimationOverrides;
+};
+
+declare type LottieAnimationData = {
+    fr: number;
+    v: string;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+};
+
+/** An SVG imported as a Preact component (the `?react` import shape). */
+declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
+
 export { }
 
 declare global {

package/dist/types/index.d.ts

@@ -1,11 +1,74 @@
 import { DEFAULT_WASM_VERSION } from '@incodetech/core/wasm';
+import { FeatureManagementRedactedUserInfo } from '@incodetech/core/feature-management';
+import { FunctionComponent } from 'preact';
 import { i18n } from 'i18next';
+import { SVGProps } from 'preact/compat';
 import { WasmConfig } from '@incodetech/core/wasm';
 
+/**
+ * Allowlisted keys for overridable Lottie animations
+ */
+export declare type AnimationKey = 'id.tutorial.front' | 'id.tutorial.back' | 'id.tutorial.passport' | 'id.flip' | 'id.processing' | 'selfie.tutorial' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in Lottie animation.
+ *
+ * - `LottieAnimationData` — a parsed Lottie JSON object.
+ * - `{ url }` — fetched and cached at runtime.
+ * - `{ animationData }` — explicit object form.
+ */
+export declare type AnimationOverride = LottieAnimationData | {
+    url: string;
+} | {
+    animationData: LottieAnimationData;
+};
+
+export declare type AnimationOverrides = Partial<Record<AnimationKey, AnimationOverride>>;
+
+/**
+ * Allowlisted keys for overridable branded SVG illustrations
+ */
+export declare type AssetKey = 'faceMatch.success' | 'faceMatch.fail' | 'documentCapture.tutorial' | 'id.uploadScreen' | 'id.ageVerification.dob' | 'id.ageVerification.scan' | 'id.ageVerification.privacy' | 'videoSelfie.success' | 'videoSelfie.fail' | 'videoSelfie.tutorial.permission' | 'videoSelfie.tutorial.selfie' | 'videoSelfie.tutorial.frontId' | 'videoSelfie.tutorial.backId' | 'videoSelfie.tutorial.poa' | 'videoSelfie.tutorial.questions' | 'videoSelfie.tutorial.speech' | 'loader.spinner';
+
+/**
+ * A customer-supplied replacement for a built-in SVG illustration.
+ *
+ * - `string` — a URL, or raw `<svg …>` markup (detected by a leading `<`).
+ * - `{ url }` — fetched and rendered via `<img>`; no script execution.
+ * - `{ raw }` — inline markup; sanitized before injection.
+ * - `{ svg }` — a precompiled component, for build-time integrations.
+ */
+export declare type AssetOverride = string | {
+    url: string;
+} | {
+    raw: string;
+} | {
+    svg: SvgComponent;
+};
+
+export declare type AssetOverrides = Partial<Record<AssetKey, AssetOverride>>;
+
 export declare function createI18n(options?: I18nOptions): i18n;
 
 export { DEFAULT_WASM_VERSION }
 
+/**
+ * Object form of the `featureManagement` option. Mirrors the core
+ * `FeatureManagementSetupOptions` shape — see the core `SetupOptions.featureManagement`
+ * docs for the full behavior (identity model, lock semantics, privacy flags).
+ */
+declare type FeatureManagementSetupOptions = {
+    clientExperimentId?: string;
+    disableStableId?: boolean;
+    disablePersistence?: boolean;
+    redactedUserInfo?: FeatureManagementRedactedUserInfo;
+};
+
+declare type FlowSetup = false | {
+    preload?: boolean;
+    mergeConfig?: boolean;
+};
+
 export declare type I18nOptions = {
     lang?: string;
     loadPath?: string;
@@ -15,14 +78,26 @@ export declare type I18nOptions = {
 
 declare type LanguageTranslations = Record<string, TranslationValue>;
 
+declare type LottieAnimationData = {
+    fr: number;
+    v: string;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+};
+
 export declare function setI18nInstance(instance: i18n): void;
 
 /**
  * Sets global UI configuration defaults for `@incodetech/ui`.
+ *
+ * Replaces (does not merge with) the previous host-supplied config, so omitting
+ * a field clears it. The dashboard theme is held separately and is unaffected.
  */
 export declare function setUiConfig(next: UiConfig): void;
 
-export declare function setup({ apiURL, token, customHeaders, timeout, wasm, ipLookup, fingerprint, devMode, i18n, uiConfig, }: SetupOptions): Promise<void>;
+export declare function setup({ apiURL, token, customHeaders, timeout, wasm, ipLookup, fingerprint, devMode, featureManagement, environment, i18n, uiConfig, flow, theme, }: SetupOptions): Promise<void>;
 
 declare type SetupOptions = {
     apiURL: string;
@@ -44,8 +119,39 @@ declare type SetupOptions = {
      * `SetupOptions.devMode` docs. WASM logging is controlled via `wasm.showLogs`.
      */
     devMode?: boolean;
+    /**
+     * Enables feature management. Forwarded to core `setup()` — see the core
+     * `SetupOptions.featureManagement` docs for the full behavior (identity
+     * model, lock semantics, privacy flags, opt-out semantics). Default: `true`.
+     */
+    featureManagement?: boolean | FeatureManagementSetupOptions;
+    /**
+     * Coarse deployment tier. Forwarded to core `setup()` — see the core
+     * `SetupOptions.environment` docs. Default: `'production'`.
+     */
+    environment?: 'development' | 'staging' | 'production';
     i18n?: I18nOptions;
     uiConfig?: UiConfig;
+    /**
+     * Controls Flow-backed standalone module configuration. Omit or pass `{}`
+     * for lazy resolution, use `preload` to fetch Flow during setup, use
+     * `mergeConfig` to merge supplied partial config over Flow config, or pass
+     * `false` to disable Flow-backed standalone configuration.
+     */
+    flow?: FlowSetup;
+    /**
+     * Controls the session dashboard theme independently from Flow. Omit or
+     * pass `{}` for compatibility-safe lazy loading, use `preload` to fetch and
+     * apply it during setup, or pass `false` to disable it.
+     */
+    theme?: ThemeSetup;
+};
+
+/** An SVG imported as a Preact component (the `?react` import shape). */
+export declare type SvgComponent = FunctionComponent<SVGProps<SVGSVGElement>>;
+
+declare type ThemeSetup = false | {
+    preload?: boolean;
 };
 
 declare type Translations = Partial<Record<string, LanguageTranslations>>;
@@ -58,6 +164,8 @@ export declare type UiConfig = {
     subtitle?: string;
     hideHeader?: boolean;
     hideFooterBranding?: boolean;
+    assets?: AssetOverrides;
+    animations?: AnimationOverrides;
 };
 
 export { }