@incodetech/web 2.0.0-alpha.1 → 2.0.0-alpha.3

package/dist/title.css

@@ -0,0 +1,38 @@
+/*! tailwindcss v4.1.17 | MIT License | https://tailwindcss.com */
+@layer properties {
+  @supports (((-webkit-hyphens: none)) and (not (margin-trim: inline))) or ((-moz-orient: inline) and (not (color: rgb(from red r g b)))) {
+    *, :before, :after, ::backdrop {
+      --tw-leading: initial;
+      --tw-font-weight: initial;
+      --tw-tracking: initial;
+    }
+  }
+}
+
+.IncodeComponent .IncodeTitle {
+  text-align: center;
+  font-size: var(--text-2xl, 1.5rem);
+  line-height: var(--tw-leading, var(--text-2xl--line-height, calc(2 / 1.5)));
+  --tw-leading: 125%;
+  --tw-font-weight: var(--font-weight-bold, var(--primitive-typography-weight-bold));
+  line-height: 125%;
+  font-weight: var(--font-weight-bold, var(--primitive-typography-weight-bold));
+  --tw-tracking: -1px;
+  letter-spacing: -1px;
+  color: var(--color-text-body-primary, var(--text-body-primary));
+}
+
+@property --tw-leading {
+  syntax: "*";
+  inherits: false
+}
+
+@property --tw-font-weight {
+  syntax: "*";
+  inherits: false
+}
+
+@property --tw-tracking {
+  syntax: "*";
+  inherits: false
+}

package/dist/types/core.d.ts

@@ -0,0 +1 @@
+export { }

package/dist/types/email/email.d.ts

@@ -0,0 +1,2 @@
+export * from '../ui/src/email/email'
+export {}

package/dist/types/email.d.ts

@@ -0,0 +1,50 @@
+import { EmailConfig } from '../../../core/src/email';
+import { FC } from 'preact/compat';
+
+/**
+ * Email verification UI component.
+ *
+ * Provides a complete email verification experience including:
+ * - Email address input with validation
+ * - OTP code entry with resend functionality
+ * - Loading states and error handling
+ *
+ * @example Basic usage
+ * ```tsx
+ * <Email
+ *   config={{
+ *     otpVerification: true,
+ *     otpExpirationInMinutes: 5,
+ *     prefill: false,
+ *   }}
+ *   onFinish={() => router.push('/next-step')}
+ *   onError={(err) => toast.error(err)}
+ * />
+ * ```
+ *
+ * @see {@link createEmailManager} for headless usage
+ */
+export declare const Email: FC<EmailProps>;
+
+/**
+ * Props for the Email component
+ */
+declare type EmailProps = IncodeModuleProps<EmailConfig>;
+
+declare type IncodeModuleProps<TConfig> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * Callback invoked when the module completes successfully.
+     */
+    onFinish?: () => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     */
+    onError?: (error: string | undefined) => void;
+};
+
+export { }

package/dist/types/flow/flow.d.ts

@@ -0,0 +1,2 @@
+export * from '../ui/src/flow/flow'
+export {}

package/dist/types/flow.d.ts

@@ -0,0 +1,46 @@
+import { FC } from 'preact/compat';
+import { FinishStatus } from '../../../core/src/flow';
+import { WasmConfig } from '../../../core/src';
+
+export declare const IncodeFlow: FC<IncodeFlowProps>;
+
+export declare type IncodeFlowProps = {
+    apiURL: string;
+    token: string;
+    wasmConfig?: WasmConfig;
+    lang?: string;
+    disableDashboardTheme?: boolean;
+    onComplete: (result: FinishStatus) => void;
+    onError?: (error: string) => void;
+    onModuleLoading?: (moduleKey: string) => void;
+    onModuleLoaded?: (moduleKey: string) => void;
+    onWasmWarmup?: (pipelines: string[]) => void;
+    spinnerConfig?: SpinnerConfig;
+};
+
+declare type PreloadConfig = {
+    apiURL: string;
+    token: string;
+    lang?: string;
+    disableDashboardTheme?: boolean;
+    wasmConfig?: WasmConfig;
+};
+
+export declare type PreloadHandle = {
+    get isReady(): boolean;
+    get error(): string | null;
+    waitUntilReady(): Promise<void>;
+    cancel(): void;
+};
+
+export declare function preloadIncodeFlow(config: PreloadConfig): PreloadHandle;
+
+export declare type SpinnerConfig = {
+    title?: string;
+    subtitle?: string;
+    size?: SpinnerSize;
+};
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
+export { }

package/dist/types/index.d.ts

@@ -0,0 +1,223 @@
+import { EmailConfig } from '../../../core/src/email';
+import { FC } from 'preact/compat';
+import { FinishStatus } from '../../../core/src/flow';
+import { i18n } from 'i18next';
+import { PhoneConfig } from '../../../core/src/phone';
+import { SelfieConfig } from '../../../core/src/selfie';
+import { TFunction } from 'i18next';
+import { WasmConfig } from '../../../core/src';
+import { WasmConfig as WasmConfig_2 } from '../../core/src';
+
+export declare const FlowCompleted: FC<FlowCompletedProps>;
+
+/**
+ * Element type for the `<incode-flow-completed>` web component.
+ *
+ * @example
+ * ```typescript
+ * const completed = document.createElement('incode-flow-completed');
+ * completed.action = 'approved';
+ * completed.scoreStatus = 'OK';
+ * document.body.appendChild(completed);
+ * ```
+ */
+export declare type FlowCompletedElement = HTMLElement & FlowCompletedProps;
+
+export declare type FlowCompletedProps = {
+    title?: string;
+    message?: string;
+    redirectionUrl?: string;
+    action?: 'approved' | 'rejected' | 'none';
+    scoreStatus?: 'OK' | 'WARN' | 'MANUAL_OK' | 'FAIL' | 'UNKNOWN' | 'MANUAL_FAIL';
+    redirectDelay?: number;
+    disableRedirect?: boolean;
+    redirectOriginOnly?: boolean;
+    flowId?: string;
+    interviewId?: string;
+};
+
+export declare const FlowStart: FC<FlowStartProps>;
+
+declare type FlowStartProps = {
+    logoUrl?: string;
+    subtitle?: string;
+    onStart: () => void;
+};
+
+declare type I18nOptions = {
+    lang?: string;
+    translations?: Translations;
+};
+
+/**
+ * Element type for the `<incode-email>` web component.
+ *
+ * @example
+ * ```typescript
+ * const email = document.createElement('incode-email');
+ * email.config = { otpVerification: true, otpExpirationInMinutes: 5 };
+ * email.onFinish = () => console.log('Email verified!');
+ * email.onError = (error) => console.error(error);
+ * document.body.appendChild(email);
+ * ```
+ */
+export declare type IncodeEmailElement = HTMLElement & IncodeModuleProps<EmailConfig>;
+
+export declare const IncodeFlow: FC<IncodeFlowProps>;
+
+/**
+ * Element type for the `<incode-flow>` web component.
+ *
+ * @example
+ * ```typescript
+ * const flow = document.createElement('incode-flow');
+ * flow.apiURL = 'https://api.example.com';
+ * flow.token = 'session-token';
+ * flow.onComplete = (result) => console.log(result);
+ * document.body.appendChild(flow);
+ * ```
+ */
+export declare type IncodeFlowElement = HTMLElement & IncodeFlowProps;
+
+export declare type IncodeFlowProps = {
+    apiURL: string;
+    token: string;
+    wasmConfig?: WasmConfig;
+    lang?: string;
+    disableDashboardTheme?: boolean;
+    onComplete: (result: FinishStatus) => void;
+    onError?: (error: string) => void;
+    onModuleLoading?: (moduleKey: string) => void;
+    onModuleLoaded?: (moduleKey: string) => void;
+    onWasmWarmup?: (pipelines: string[]) => void;
+    spinnerConfig?: SpinnerConfig;
+};
+
+export declare type IncodeModuleProps<TConfig> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * Callback invoked when the module completes successfully.
+     */
+    onFinish?: () => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     */
+    onError?: (error: string | undefined) => void;
+};
+
+/**
+ * Element type for the `<incode-phone>` web component.
+ *
+ * @example
+ * ```typescript
+ * const phone = document.createElement('incode-phone');
+ * phone.config = { otpVerification: true, otpExpirationInMinutes: 5 };
+ * phone.onFinish = () => console.log('Phone verified!');
+ * phone.onError = (error) => console.error(error);
+ * document.body.appendChild(phone);
+ * ```
+ */
+export declare type IncodePhoneElement = HTMLElement & IncodeModuleProps<PhoneConfig>;
+
+/**
+ * Element type for the `<incode-selfie>` web component.
+ *
+ * @example
+ * ```typescript
+ * const selfie = document.createElement('incode-selfie');
+ * selfie.config = { showTutorial: true };
+ * selfie.onFinish = () => console.log('Selfie captured!');
+ * selfie.onError = (error) => console.error(error);
+ * document.body.appendChild(selfie);
+ * ```
+ */
+export declare type IncodeSelfieElement = HTMLElement & IncodeModuleProps<SelfieConfig>;
+
+declare type InferState<T> = T extends {
+    getState: () => infer S;
+} ? S : never;
+
+declare type LanguageTranslations = Record<string, TranslationValue>;
+
+declare type PreloadConfig = {
+    apiURL: string;
+    token: string;
+    lang?: string;
+    disableDashboardTheme?: boolean;
+    wasmConfig?: WasmConfig;
+};
+
+export declare type PreloadHandle = {
+    get isReady(): boolean;
+    get error(): string | null;
+    waitUntilReady(): Promise<void>;
+    cancel(): void;
+};
+
+export declare function preloadIncodeFlow(config: PreloadConfig): PreloadHandle;
+
+/**
+ * Sets global UI configuration defaults for `@incodetech/ui`.
+ */
+export declare function setUiConfig(next: UiConfig): void;
+
+export declare function setup({ apiURL, token, customHeaders, timeout, wasm, i18n, uiConfig, }: SetupOptions): Promise<void>;
+
+declare type SetupOptions = {
+    apiURL: string;
+    token: string;
+    customHeaders?: Record<string, string>;
+    timeout?: number;
+    wasm?: WasmConfig_2;
+    i18n?: I18nOptions;
+    uiConfig?: UiConfig;
+};
+
+export declare type SpinnerConfig = {
+    title?: string;
+    subtitle?: string;
+    size?: SpinnerSize;
+};
+
+declare type SpinnerSize = 'small' | 'medium' | 'large';
+
+declare type Translations = Partial<Record<string, LanguageTranslations>>;
+
+declare type TranslationValue = string | Record<string, unknown>;
+
+export declare type UiConfig = {
+    logoSrc?: string;
+    logoHeight?: string;
+    hideHeader?: boolean;
+    hideFooterBranding?: boolean;
+};
+
+/**
+ * Hook for subscribing to manager state updates
+ * @param factory - Factory function that creates the manager instance
+ * @param options - Configuration options
+ * @returns Tuple of [state, manager]
+ */
+export declare function useManager<TManager extends {
+    getState: () => TState;
+    subscribe: (listener: (state: TState) => void) => () => void;
+    load?: () => void;
+}, TState = InferState<TManager>>(factory: () => TManager, options?: UseManagerOptions): [TState, TManager];
+
+declare type UseManagerOptions = {
+    autoLoad?: boolean;
+};
+
+export declare function useTranslation(): UseTranslationReturn;
+
+declare type UseTranslationReturn = {
+    t: TFunction;
+    ready: boolean;
+    i18n: i18n;
+};
+
+export { }

package/dist/types/phone/phone.d.ts

@@ -0,0 +1,2 @@
+export * from '../ui/src/phone/phone'
+export {}

package/dist/types/phone.d.ts

@@ -0,0 +1,51 @@
+import { FC } from 'preact/compat';
+import { PhoneConfig } from '../../../core/src/phone';
+
+declare type IncodeModuleProps<TConfig> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * Callback invoked when the module completes successfully.
+     */
+    onFinish?: () => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     */
+    onError?: (error: string | undefined) => void;
+};
+
+/**
+ * Phone verification UI component.
+ *
+ * Provides a complete phone verification experience including:
+ * - Country code selector with flag emojis
+ * - Phone number input with validation
+ * - OTP code entry with resend functionality
+ * - Loading states and error handling
+ *
+ * @example Basic usage
+ * ```tsx
+ * <Phone
+ *   config={{
+ *     otpVerification: true,
+ *     otpExpirationInMinutes: 5,
+ *     prefill: false,
+ *   }}
+ *   onFinish={() => router.push('/next-step')}
+ *   onError={(err) => toast.error(err)}
+ * />
+ * ```
+ *
+ * @see {@link createPhoneManager} for headless usage
+ */
+export declare const Phone: FC<PhoneProps>;
+
+/**
+ * Props for the Phone component
+ */
+declare type PhoneProps = IncodeModuleProps<PhoneConfig>;
+
+export { }

package/dist/types/selfie/selfie.d.ts

@@ -0,0 +1,2 @@
+export * from '../ui/src/selfie/selfie'
+export {}

package/dist/types/selfie.d.ts

@@ -0,0 +1,24 @@
+import { FC } from 'preact/compat';
+import { SelfieConfig } from '../../../core/src/selfie';
+
+declare type IncodeModuleProps<TConfig> = {
+    /**
+     * Module configuration required to render the flow.
+     * For Web Components, this is typically assigned via `element.config = ...`.
+     */
+    config?: TConfig;
+    /**
+     * Callback invoked when the module completes successfully.
+     */
+    onFinish?: () => void;
+    /**
+     * Callback invoked when a fatal module error occurs.
+     */
+    onError?: (error: string | undefined) => void;
+};
+
+export declare const Selfie: FC<SelfieProps>;
+
+declare type SelfieProps = IncodeModuleProps<SelfieConfig>;
+
+export { }

package/dist/types/styles/core.d.ts

@@ -0,0 +1 @@
+export {}