@incodetech/web 2.1.1 → 2.2.0-rc.0

package/dist/types/antifraud.d.ts

@@ -1,11 +1,66 @@
 import { AntifraudConfig } from '@incodetech/core/antifraud';
 import { AntifraudManager } from '@incodetech/core/antifraud';
+import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
+import { SVGProps } from 'preact/compat';
 
-export declare const Antifraud: FC<AntifraudProps>;
+/**
+ * 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>>;
+
+export declare const Antifraud: FC<Omit<AntifraudProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
 
 declare type AntifraudProps = IncodeModuleProps<AntifraudConfig, void, AntifraudManager>;
 
+/**
+ * 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;
+
 /**
  * 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
@@ -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,6 +116,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/authentication.d.ts

@@ -1,13 +1,68 @@
 import { AuthenticationConfig } from '@incodetech/core/authentication';
 import { AuthenticationManager } from '@incodetech/core/authentication';
+import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
+import { SVGProps } from 'preact/compat';
 
-export declare const Authentication: FC<AuthenticationProps>;
+/**
+ * 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>>;
+
+export declare const Authentication: FC<Omit<AuthenticationProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
 
 declare type AuthenticationProps = IncodeModuleProps<AuthenticationConfig & {
     authHint?: string;
 }, void, AuthenticationManager>;
 
+/**
+ * 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;
+
 /**
  * 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
@@ -28,12 +83,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.
      */
@@ -59,6 +118,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/certificate-issuance.d.ts

@@ -1,13 +1,68 @@
 import { CertificateIssuanceConfig } from '@incodetech/core/certificate-issuance';
 import { CertificateIssuanceManager } from '@incodetech/core/certificate-issuance';
+import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
+import { SVGProps } from 'preact/compat';
 
-export declare const CertificateIssuance: FC<CertificateIssuanceProps>;
+/**
+ * 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>>;
+
+export declare const CertificateIssuance: FC<Omit<CertificateIssuanceProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
 
 declare type CertificateIssuanceProps = IncodeModuleProps<CertificateIssuanceConfig> & {
     manager?: CertificateIssuanceManager;
 };
 
+/**
+ * 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;
+
 /**
  * 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
@@ -28,12 +83,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.
      */
@@ -59,6 +118,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/consent.d.ts

@@ -1,8 +1,63 @@
 import { ConsentConfig } from '@incodetech/core/consent';
 import { ConsentManager } from '@incodetech/core/consent';
+import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
+import { SVGProps } from 'preact/compat';
 
-export declare const Consent: FC<ConsentProps>;
+/**
+ * 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 Consent: FC<Omit<ConsentProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
 
 declare type ConsentProps = IncodeModuleProps<ConsentConfig, void, ConsentManager>;
 
@@ -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,6 +116,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/cross-document-data-match.d.ts

@@ -1,9 +1,65 @@
 import { CrossDocumentDataMatchConfig } from '@incodetech/core/cross-document-data-match';
+import { CrossDocumentDataMatchManager } from '@incodetech/core/cross-document-data-match';
+import { DeepPartial } from '@incodetech/core/flow';
 import { FC } from 'preact/compat';
+import { FunctionComponent } from 'preact';
+import { SVGProps } from 'preact/compat';
 
-export declare const CrossDocumentDataMatch: FC<CrossDocumentDataMatchProps>;
+/**
+ * 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 CrossDocumentDataMatchProps = IncodeModuleProps<CrossDocumentDataMatchConfig>;
+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 CrossDocumentDataMatch: FC<Omit<CrossDocumentDataMatchProps, "config"> & {
+    config?: (Omit<unknown, never> & DeepPartial<Pick<unknown, never>>) | undefined;
+}>;
+
+declare type CrossDocumentDataMatchProps = IncodeModuleProps<CrossDocumentDataMatchConfig, void, CrossDocumentDataMatchManager>;
 
 /**
  * Extra context passed to `onFinish` alongside the result. Lets a host decide
@@ -25,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.
      */
@@ -56,4 +116,28 @@ 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 { }