@usefillo/dom 0.6.2 → 0.8.0

package/README.md

@@ -12,7 +12,7 @@ npm i @usefillo/dom
 import { renderForm } from "@usefillo/dom";
 import "@usefillo/dom/styles.css"; // optional default theme — or bring your own
 
-renderForm(document.querySelector("#fillo-form"), {
+renderForm("#fillo-form", {
   formId: "cust-feedback",
   onSubmitted: (id) => console.log("response", id),
 });
@@ -32,7 +32,7 @@ const form = defineForm({
   ] }],
 });
 
-renderForm(document.querySelector("#fillo-form"), {
+renderForm("#fillo-form", {
   form,
   client,
   onSubmitted: (id) => console.log("response", id),
@@ -47,15 +47,18 @@ Or drop it in with a single script tag — the bundle exposes a global `Fillo`:
 <script>
   const client = Fillo.createClient({ key: "pk_…" });
   const form = Fillo.defineForm({ id: "cust-feedback", pages: [/* … */] });
-  Fillo.renderForm(document.querySelector("#fillo-form"), { form, client });
+  Fillo.renderForm("#fillo-form", { form, client });
 </script>
 ```
 
-For tiny feedback widgets, set `settings.submitMode: "auto"` on a select/rating/checkbox/dropdown/linear scale form. The default renderer hides the first submit button, submits after a complete discrete answer, and brings the submit button back if that answer opens a text or upload follow-up. Add `submissionLimit: "once_per_visitor"` for browser-scoped one-response feedback.
+For tiny feedback widgets, set `settings.submitMode: "auto"` on a select/rating/checkbox/dropdown/linear scale form. The default renderer hides the first submit button, submits after a complete discrete answer, and brings the submit button back if that answer opens a text or upload follow-up. Add `responseLimit: { by: "browser", onRepeat: "keep" }` for browser-scoped one-response feedback.
 
 The default stylesheet follows system dark mode for unthemed embeds. Pass `theme: { colorScheme: "dark" }` or `"light"` when the host surface is known.
 
-Re-exports the core embedding surface from [`@usefillo/core`](https://www.npmjs.com/package/@usefillo/core) (`createClient`, `FilloClient`, `FormSchema`, validation/logic helpers, …).
+Re-exports the core pieces used by DOM integrations from
+[`@usefillo/core`](https://www.npmjs.com/package/@usefillo/core), including
+`createClient`, `defineForm`, `FilloClient`, `createFormController`, and the
+schema/value types.
 
 ## Links
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Field, FieldValue, FormSchema, FilloClient, ResponseData, FormStatus as FormStatus$1, FormPage, Block, CodeForm, FormTheme, FieldKind, FilloError, FormControllerOptions, FormController } from '@usefillo/core';
+import { Field, FieldValue, FormSchema, FilloClient, ResponseData, FormStatus as FormStatus$1, FormPage, Block, FilloRespondent, CodeForm, FormTheme, 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";
@@ -50,6 +50,12 @@ interface RenderFormOptions {
     formId?: string;
     theme?: FormTheme;
     initialData?: ResponseData;
+    /**
+     * identify(): the host app's account context for the person filling the
+     * form ({ id, email?, name?, traits? }). Recorded with the response as an
+     * unverified claim. Late-bind with setRespondent() once a session loads.
+     */
+    respondent?: FilloRespondent;
     className?: string;
     components?: Partial<Record<FieldKind, FieldRenderer>>;
     customComponents?: Record<string, FieldRenderer>;
@@ -68,6 +74,13 @@ interface FilloDomForm {
     next(): void;
     back(): void;
     submit(): Promise<void>;
+    /** Late-bind identify() context once the host session loads. */
+    setRespondent(respondent: FilloRespondent | undefined): void;
+    /** Persist unsaved saved-progress answers now (settings.saveProgress forms).
+     *  The renderer already flushes on pagehide/visibility-hidden. */
+    flushDraft(): void;
+    /** Discard the saved draft and reset to a fresh fill ("Start over"). */
+    resetDraft(): void;
     destroy(): void;
 }
 declare function renderForm(target: HTMLElement | string, options: RenderFormOptions): FilloDomForm;