@usefillo/dom 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Field, FieldValue, FormSchema, FilloClient, ResponseData, FormStatus as FormStatus$1, FormPage, Block, FilloRespondent, CodeForm, FormTheme, FieldKind, FilloError, FormControllerOptions, FormController } from '@usefillo/core';
+import { Field, FieldValue, FormSchema, FilloClient, ResponseData, FormStatus as FormStatus$1, FormPage, Block, FilloRespondent, CodeForm, FormTheme, ChallengeConfig, FieldKind, FilloError, FormControllerOptions, FormController } from '@usefillo/core';
 export { CodeForm, Field, FieldKind, FieldValue, FileValue, FilloClient, FilloClientOptions, FilloError, FormController, FormControllerOptions, FormControllerState, FormSchema, FormTheme, ProvisionWorkspaceResult, ResponseData, createClient, defineForm, provisionWorkspace } from '@usefillo/core';
 
 type FormStatus = FormStatus$1 | "loading" | "closed";
@@ -34,7 +34,6 @@ interface FieldRenderContext {
     uploadFiles?: (field: Extract<Field, {
         kind: "file_upload";
     }>, files: File[]) => Promise<void>;
-    uploadProgress?: Map<string, number>;
 }
 interface FilloDomFieldIds {
     inputId: string;
@@ -44,10 +43,7 @@ interface FilloDomFieldIds {
     name: string;
 }
 type FieldRenderer = (context: FieldRenderContext) => HTMLElement | null;
-interface RenderFormOptions {
-    form?: FormSchema | CodeForm;
-    client?: FilloClient;
-    formId?: string;
+interface RenderFormBaseOptions {
     theme?: FormTheme;
     initialData?: ResponseData;
     /**
@@ -56,6 +52,13 @@ interface RenderFormOptions {
      * unverified claim. Late-bind with setRespondent() once a session loads.
      */
     respondent?: FilloRespondent;
+    /**
+     * Human-verification challenge config (public site key + provider). Normally
+     * read from the form fetch/sync automatically; pass it explicitly only when
+     * rendering an inline `form` schema and still wanting the widget (Fillo's
+     * hosted page does this). Wins over anything the server delivers.
+     */
+    challenge?: ChallengeConfig;
     className?: string;
     components?: Partial<Record<FieldKind, FieldRenderer>>;
     customComponents?: Record<string, FieldRenderer>;
@@ -80,6 +83,32 @@ interface RenderFormOptions {
     renderSuccess?: (api: FilloDomApi) => HTMLElement;
     renderError?: (error: FilloError) => HTMLElement;
 }
+type HostedRenderFormOptions = RenderFormBaseOptions & {
+    formId: string;
+    form?: undefined;
+    client?: FilloClient;
+    renderOnly?: false;
+};
+type InlineTargetedRenderFormOptions = RenderFormBaseOptions & {
+    form: FormSchema | CodeForm;
+    formId: string;
+    client?: FilloClient;
+    renderOnly?: false;
+};
+type CodeBackedRenderFormOptions = RenderFormBaseOptions & {
+    form: CodeForm;
+    client: FilloClient;
+    formId?: undefined;
+    renderOnly?: false;
+};
+type RenderOnlyFormOptions = RenderFormBaseOptions & {
+    form: FormSchema | CodeForm;
+    client?: FilloClient;
+    formId?: string;
+    /** Explicit local preview: submission, uploads, and saved progress are disabled. */
+    renderOnly: true;
+};
+type RenderFormOptions = HostedRenderFormOptions | InlineTargetedRenderFormOptions | CodeBackedRenderFormOptions | RenderOnlyFormOptions;
 interface FilloDomForm {
     readonly element: HTMLElement;
     readonly status: FormStatus;
@@ -127,6 +156,8 @@ declare class FilloFormElement extends HTMLElementBase {
      *  them, and a stringified `false` must never enable dev chrome for real
      *  respondents. Disable by removing the attribute or setting it to "false". */
     private previewAttrEnabled;
+    /** Explicit local-preview mode for custom-element integrations. */
+    private renderOnlyAttrEnabled;
     private mount;
 }
 declare function registerFilloElement(name?: string): void;